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REVISTON DEFINITION SHEET 


REV } DATE ; DESCRIPTION 


% a 
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1 07/11783 Update for SES Version 1.0 Level 23. 
Includes descriotions of new 
proceduress updates and corrections to 


old procedures. 


2 12/13783 Update for SES Version 1.0 Level 24, 
Includes descriptions of new 
procedures», updates and corrections to 
old procedures. 

3 05/22/84 Update for SES Version 1.20 Level 25. 
Includes descriotions of new 
proceduress updates and corrections to 
old procedur ese 

4 08/14/84 Update for SES Version 1.0 Level 26. 
Includes descriptions of new 
proceduress updates and corrections to 

4A 12/18/84 This revision reflects SES Usability 


Tools at Level 6178 Incorporating the 
following features and changes: FTINTODD 
and FINTOSCT tools added for’ gener ating 
structure charts fron FORTRAN source 
code; newly named SCADG and SCADGEDIT 
replacing CADSG and SADSGEDIT; XREFMAP 
cross reference tool added; SCOOP file 
comparison tool added; S$ORT5 replacing 
al! internal uses of SORT/MERGES; 
EXPLAIN interface to new ontine 
Miscellaneous Routines Interface 
Reference Manual; ninor enhancements to 
GOFs GOL» COMs DEIMs DIIM» BINDO68K and 
TRANDILIB. 


4a a 
% a 
3 3 
FY ? 
% a 
F F 
2 8 
3 3 
$ 
% 8 
SY % 
4 % 
a t 
b % 
g 8 
§ 3 
a 3 
3 $ 
% a 
% a 
a : 
3 a 
3 E 
2 3 
3 $ 
3 2 
a a 
4 2 
3 3 
2 2 
s a 
? } 
2 a 
2 ; 
% 3 
2 3 
2 3 
3 : old procedures. 
3 3 
2 4 
3 EY 
3 2 
a 3 
F 5 
a a 
a 3 
SY 3 
4 a 
4 a 
a F 
: 8 
3 a 
4 3 
tL} 2 
Fs a 
2 a 
a t } 
4 e 
3 8 
3 
3 a 
3 a 
$ | 
s 8 
8 3 
8 a 
a F 
a g 
a $ 
a 3 
3 $ 
4 a 
8 E | 
8 | 
a 2 
a a 


c COPYRIGHT CONTROL DATA 198231983s1984 
Ali Rights Reserved 


3 
COC = SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook | REV: 4A 


NOTICE: 


The content of this manual obtained from DCS may differ from the 
on~line version. The on-iine version reflects exactiy the SES tool 
set installed on your development machine at your sites whereas the 
DCS version describes the full SES tool set and all available 
options. 
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1.0 PREFACE 


This manual describes the procedural user interface to all of the 
Software Engineering System (SES) Usability Tools under the five 
product packages tisted below: 


1. NOS _Iooiss This is the core set of SES tools and is required by 
the other four packages. This set of tnots is sometimes 
referred to in this manual (and others) as the 170 SES tools» 
SES tools or simply SES. Ati SES procedures that are not 
included in the other four packages are inctuded in this one. 


2 CYBIL_170 Code Generator, This product is aiso referred to as 
CYBIL-CC. The SES procedures in this neackage are CYBIL» 
CYBFORM»s GETCOMN, GETCCDB and GETLIB. 


3e CYBIL P-Code Generators. This product is also referred to as 
CYBIL-CP. The SES procedures tlisted for CYB3IL-CC plus all of 
the procedures described in the SES Ohb]}ect Code Utilities 
chapter and the UCSD P-Code Environment chapter in this manual. 


4. NOS._DEEINE. This product package consists of the data 
dictionary utilities described in the Structured Process Tools 
chapter. It is sometimes referred to as CANS OD. 


5. NOS _GRAPH. This product package is also cattYed CADSG or CADS 
Graphics and consists of the SES interfaces CADSG and CADSGEDIT 
described in the Structured Process Too!s chapter. 


6e NOS_CHART2 This product package consists of the CYBIL to 
structure chart too!s described in the Structured Process Tools 
chapter. 


7. CDOCNET Support IoQgls. This product is also referred to as 
Network Tools. These tools provide a Matorofa M4C48000 
development environment on a CYBER 170. 


Each of these product packages can be ordered separately from 
Control Data and can be installed in any combination which inctudes 
the NOS Toots package. 
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1.1 INTRODUCTION 


Wee Software stands between the user and the machine ee." 
Harian De Mills. 


The Software Engineering System (SES) provides task oriented or 
procedural access to a collection of Software LTools» running on the 
Network Operating System (NOS). An underlying philosophy of SES 


is : where therets a function or task to be dones provide a 
PROCEDURE to do it. Programs are generality not used directtys 
rather they are accessed via SES procedures that provide a 


consistent access method. 


This SES User's Handbook is intendad both as a tutorial 
introduction for new SES users (who should definitely read this 
chapter), and also as a reference manual for’ exserienced SES userse 
Although this is not the only existing raftevant SES documents it's 
the main trunk of the tree of knowledge of what SES PROCEDURES are 
available. This SES Userts Handbook is usually undated onty at SES 
Releases. 


Software Production covers many areas other than the narrow 
fields of "assemblerss compilers and toaders",. To cover the wider 
areass we need good tools. SES provides the tools. This SES User's 
Handbook is arranged in chapters that "“"cluster™ around related 
functional areas (such as document formattinags File managements text 
processing and so on)e This chapter is a general introduction to 
the concepts of SES and its usee The remaining chapters of this 
handbook cover the functional areas. S3e!fow ts a brief summary of 
the contents of the remaining chapters. 


A major proportion of SES is devoted to the CYBER 180 SIMULATED 
ENVIRONMENT, running on the CYBER 170. The chanoter called "CYBER 
180 Virtual Environment Creation and Simulation? contains 
information on obullding the virtual environments simulatings and 
transferring text files back and forth between the CYBER 180 and 
CYBER 170. The chapter on *CYBER 180 Abject Code Utitities! 
describes the CYBER 180 OBJECT CODE UTILITY» used to manage CYBER 
180 Gbhject Text. One of CYBER 180's significant differences from 
CYBER 170 is the use of real eight~bit ASCTT. NAS runs on a six~-bit 
oriented systems and provides oniy partial support of ASCII. SES 
provides extensive support for ASCII. The CY8IL compiler is ASCII 
orienteds as is the CYBIL formatter, the docunentation facilitiess 
many of the text manipulation tootss and the source text maintenance 
utilities. 


Of courses Compilers, Assemblers and Loaders dg play a part in 
software production - the chapter called 'Compoiltings Linking and 
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Debugging’ covers a tot of useful tools in this area. Included in 
this chapter is the CYBER IMPLEMENTATION LANGUAGE - CYBIL.»~ As well 
as a CYBIL compilers this chapter also describes CYBIL-CC 
INTERACTIVE DEBUGs a symbotic debug facilfityvs based on CYBER 
Interactive Debug but orfented towards CYRIL code. 


Production of targe for smat!l) software systens requires some 
means of MANAGING SOURCE TEXT to avoid a tot of detail work. SES 
supplies a comprehensive collection of source text maintenance 
procedures geared up for the ASCII version of MODIFY (known as 
MADIFY) to manage ASCII source text for yous ors in facts any other 
ASCII texts such as documents, data dictionariess process 
descriptions and so on. These facilities are described in the 
chapter catied "Source Text Maintenance. The chapter entitled 
*Source Code Utility on NOS 170% describes the NO$-170 version of 
the CYBER 180 Source Code Utility (SCJ).  Therets also a set of 
procedures to make UPDATE easier to !ive withs, described in 
tHandling Update Program Libraries!,. 


When you've compiled or assembied vour source text of course 
there's the question of OBJECT CODE MANAGEMENT. The chapter on 
'Library Or Multi Record File Management Using LIBEDIT® covers 
LIBRARY MANAGEMENT — a collection of procedures that interface to 
the NOS LIBEDIT utitity.e These library management procedures can in 
fact handie things other than object code. 


One of the first nurdies to clear on most computer systems seems 
to involve the question “how do I print a file"? The chapter on 
‘Printing Files! shows that printing files really can be easye 


An important part of software production involves DOCUMENTATION, 
SES thas a collection of toots that make a fun job of generating 
beautiful documents. Documentation aids revolve around the TXTCODE 
document formatters used to produce this Handbook. The *Document 
Formatting System! chapter covers document formatting. 


Preparing beautifully formatted source text For high tevel 
language processors is something you tike to haves but you'd rather 
not do it yourself. Various types of preprocessors are covered in 
the chapter on 'Source Text Preprocessors'’,! 


In any time sharing systems MANAGING FILES Is an important part 
of tifes as is FINDING OUT WHAT'S GOING ON.’ 'Getting Information! 
relates to getting informations such as your filess timitss dayfile»s 
while the chapter on "Filespace Management! covers the aspect of 
dumping your files to tapes and hanging on to files vou want to hang 
on toe 


An amazing amount of the daily job of software production 
involves massaging text in some way or another. Text Manipulation 
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and Conversion Utilities*® covers many aspects of TEXT MANIPULATION. 
Conversion of character sets tends to be a way of fife rather than 
an infrequent exercises and there are utifftties to work well with 
the NOS version of ASCII. 


Software Production really is a community activitys and 'SES 
Communications't describes facilities for users to talk to each other 
via a mail system. 


SES PROCEDURES take care of the details of using softwares such 
as locatings returning and rewinding files» obtaining required 
memorys obtaining required utility prograns to perform tasks» and so 
ons teaving you free to specify what you want done. To state it 
briefly 3: 


YOU decide WHICH SES PROCEDURE you want to use for the job. 
SES generates the J08 CONTROL STATEMENTS to do the job. 


Using SES» you can run aeprocedure diractty as part of your 
interactive sessions or you can make many of the procedures run 
independently as batch jobs. 


Experienced or curfious users wishing to create their own SES 
procedures can read the SES Procedure Writer’*s Suide. 


At the end of this chapter there*s a list of documents relevant 
to peaceful and productive coexistence with NOS.! 


As you read this documents you'tt! notice that although many SES 
procedures have lots of parameters» most oarameters are optional. 
For examples the PRINT and FORMAT procedures: haves respectivelys ten 
and eighteen parameters; 902% of PRINT and FORMAT usage requires only 
one parameter. Finatlys the ysability of SES results from people 
using it and feeding back their (constructive) criticisms, ideas for 
enhancements to existing facilities and ideas for new facilities. 
We hope you'tli do the same. 


Note : We strongty recommend that you read afi of this 
introductory chapter before reading other chapters. AS you read 
this introductions try using some of the SES procedures described in 
the examples as you goe Finally 3: 


When all else failss read the documentation! 
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1.0 PREFACE 


Lelei USING AN SES PROCEDURE 

Whether you use SES interactivelys or run it in a batch jobs the 
usage is the sames as shown here 3; 

seseprocedure_name ltist_of_parameter's 
the ses before the period starts the SES processor. The period (.) 
following ses is ceguired to keep NOS hapoy. The statement directs 
the SES processor to locate the procedure given by procedure names 
and when it has been tocateds to process that procedure and 
substitute the f{optional) parameters given by list lof parameters, 
and finally» execute the procedure either directiy ("while you 
wait") as part of your interactive sessions or SU3IMIT the procedure 
as an Independent job. For example : 
seseprint blivet 
PRINTs file blivet on the ASCII printers and 3: 
sesecount tines in grundge 


COUNTs the number of fines in file grundge.. 


1lele2 PARAMETERS FOR SES PROCEDURES 

As mentioned aboves you use an SES procedure by typing a 
statement of the form : 

seseprocedure_name list lof parameters. 
where fistlof_parameters is the parameters required for that 
particular procedure. 
Parameters may be specified by keywords for exanote : 
seseprint fzmyfile 

In this example, f is the parameter keyword or parameter ngme»s and 
myfile is the parameter yaluee Generally» the nane on the feft of 


the equal sign is the parameter keyword or oaraneter pngme» while the 
thing on the right of the equal sign is the parameter yaglue. 
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While parameters may be specified by keywords it%s also possible 
{and usually more convenient) to leave out the keyword and the equal 
sign and specify parameters positionally. This means that you don't 
have to type the keyword or the equal sign. For example : 


sesecopyacr infiles outfiles 3..79 


When keywords are useds it doesn't matter in what order you code the 
parameters. The use of COPYACR above could have been coded 3: 


sesecopyacr ozoutfiles 3.42799 izinfile 


however if you want to code parameters without using keywords» you 
must get them in the right order. 


When you use an SES procedure you can code parameters in a 
mixture of both positional and keyword forms, whatever suits you. 


Every SES procedure expects its parameters in a specific order. 
When you code a parameter by keywords you effectively “"tab™® the 
parameter number to that "position". That's why» in the example 
aboves we were able to code ?: 


ozoutfiltes 34279 


by coding ozoutfile we "tabbed" the oarameter’ to the second 
"position". The next parameter (coded without the keyword) was 
already in the third “position™. But when we wanted to code the 
input File name we had to specify it by keyword in order to "tab" 
back to the first parameter position. 


Use of positional parameters sometimes leads to minor probtems 
when what you think is a File name is in fact the keyword for a 
parameter. For examples many SES procedures have a parameter called 
groups which is the name of a group (or multi record) file. If you 
use a procedure such as COLLECTs for instances tike this 3: 


sesecollect (toms dicks harry) group 
**¥E CL 110012 EXPECTING "“vatuet(s) for parameter GROUP®™ ON 
COMMAND STATEMENT 


in this cases the error message actually neans 3: you have coded a 
parameter keywords» and not suppiied a value for that parameter. In 
such cases» you have to either code groupsgroup» of code the 
positional value in string quotes =: *group?.' 


Most SES procedures use short names like f£ and f for parameter 
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keywordss so it's best if you avoid single tetter filenames. For. 
example 3. 


seseuptotow f 
will cause an errors because f is one of the keywords for the first 


parameter of UPTOLOW. You can either code the parameter as f2fs or 
code it as 'f*,s or use a name tike grab or junk for’ the filename. 
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1.1-2.1 Types of Parameter Values 


Values supplied for parameters may be Qanese long names: numberse 
or character strings» These are described in detaif here. 


Lele2e1.1 NAMES _AS_ PARAMETER. VALUES 
A NAME is from one to seven characters tong. I[t must start with 
a letters and may contain only letters or digits. For example : 


A» ZQ91LAP6» and FILEA are valid names» whereas 3. LAJ» input _ files 
and oversizedname are invalid names according to the rutes above. 
An example of using names in an SES procedure is ? 


seseuptotow ixhibrows ozlowbrow 


for converting file hibrow from upper case to lower case with the 
result appearing on file towbrow. 


Lele2e1l.2 LONG _ NAMES AS _ PARAMETER VALUES 

A LONG NAME is from one to 31 characters long. It must start 
with a letters and may contain letters,» digits and the special 
characters 3 #5 %» » @ Any valid NAME is also a valid LONG NAME> 
as are input file and oversidedname. 


1e1e2e1+3 NUMBERS AS. PARAMETER. VALUES 
A NUMBER contains only digits. The nunber may be followed by = an 
optional BASE. For exampie :. 


579110) 1493 are DECIMAL NUIMBERSs or numbers to the 
base 10. 

677(8) 1754(8) are OCTAL NUMBERS» or numbers to the 
base 8. 

OAF 6116) 3E8(16) are HEXADECIMAL NUMBERS» or numbers to 


the base 16. Note that hexadecimal 
numbers must begin with a decimal 
digits even if vou have to start them 
with a zeroe This avoids a potential 
confusion of a haxadecimal number with 
a namee 
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Numbers such as 6789(8) and 3A5{10) are distiked by SES. Use of 
numeric parameters occur in procedures fike 3 


seseprint ceopiess3, fzyinyang 


to print three (3) copies of file yinyang on the ASCII printer. 


Lele2ele4 CHARACTER STRINGS _AS_ PARAMETER VALUES 

A CHARACTER SIRING is any arbitrary string of characters enctosed 
in single quote signs (*). If you wish to include a single quote 
sign in a strings you must represent it by two quote signs in a row. 
For example 3: 

*this is an exampie of a character string? 

*quote signs must be represented by two '* quote signs in a row? 

You use strings in SES procedures when you: have to supply strange 
names such as SYM$SM» and when supolying sentences to procedures : 

sesegenupcf d='*mes$c30! 

when generating an update compile files and 3: 


seselinkl70 binfiles xid=*tdset(usepzswisysssubstesnlsy-$swisy.13)! 


to give extra toader directives to LINK179.° 
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1.1.2.2 Ranges_of Parameter Values 


Some SES procedures handte parameter values in the form of a 
RANGE. For instances procedure COPYACR has a parameter named cols» 
which represents a pair of column numbers. You can write the cols 
parameter in the form 3: 


cols232.65 
the pair of periods is called an ELLIPSIS. The range specification 
consists of a low side» on the teft of the elflinsis»s and a high side 
on the right of the ellipsis. Another exanole of a procedure that 
accepts ranges is GENCOMP, which accepts ranges of module names» 
like this : 
sesegencomp aimaden..bertero 
which refers to all modules almaden through bertero inclusives and ? 
sesesetect lines 102.20 of galtoop 


to display lines 10 thru 20 of file galloop at the terminal. 
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1.1.23 Lists.of Values for Parameters 


Some SES procedures handte parameters consisting of many vaiues. 
For instances you can tell procedure PRINT to orint a whole bunch of 
filess like this 3 


seseprint f2=l(atiass orions mercurys pegasuss siriuss hermes) 


the value coded for the f€ parameter is called a YALWE LIST. A vatue 
fist must be enclosed in parentheses» as shown in the example. The 
individual items in a value fist are called ELEMENTS of the tists 
and they are separated from each other by a comma, 


Elements in a value list can also be ranges :. 


seseselect fines (1s 25 39 120017» 210225) of widget 


An element of -a value tist may itself be another’ value list. For 
Instances procedure GENCOMP has a parameter called abs which can be 
coded in the form 3 


gencomp ab=((rieslings mondavi)s ganays (chentins wente)) 


to get aiternate bases from other user's catalogs. Note that the 
first and second elements in each of the sublists are the filename 
and the users catalog names respectively. The description of the 
GENCOMP procedure talks more about the ab parameter. Also see the 
note below, at the end of this description on parameter Jists. 
Procedure ASORT uses tists of lists to indicate the columns for the 
sort keys : 


seseasort izganips ozganops keysz(tls 539 (45 TVs dd) 
Each sublist in the tist above is a single sort key; the elements in 
the sublists are the start columns tengths and direction of sort. 


See the description of the ASORT procedure for nore information. 


If you code onty one value for a parameters you can teave the 
parentheses offs tike this : 


seseprint femyfile. 


but as soon as you want to supply more than one value you must 
supply the parenthesess like this °: 


seseprint {bownmores juras niltown) 


1-12 
CDC — SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
1.0 PREFACE 
1.212223 Lists of Values for Parameters 


’ 


Such are calfed multi valued parameters» or’ value Lists» or just 
plain lists. 


Referring to the discussion on the ab parameter of GENCOMP aboves 
a few SES procedures handle parameters of that form. Those 
parameters are somewhat special forms for accessing files from other 
users’ catalogs» for examples the LINK170 procedure uses this form 
for the list of tibraries : 


seselinki70 pe((lib_lstib_2suser_1)stib_3sliib_4,lib_5suser_2)) 


each element in the outer parenthesised tist ts itself a list 
{possibiy containing only one element) of tibrarites and the places 
to get them from. Sos in this examples the First sublist says ? 
obtain lib_1 and fib_.2 from the catalog of user_1; the second 
sublist has onty gone elements which means * obtain tib.3 from the 
catalog of the current user; the third sublist says. : obtain Jib 4 
and Jib.5 from the catalog of user_2. For’ orocedures that use this 
form of parameters the fast element in each of the sublists is the 
user name of the cataiog from whence to obtain the Files. 
Conversely ;: 


seseflinkl170 pz(libil»s libi2s Libi3s Fibl4> Pib_5) 


means : obtain all five library files fron the catalog of the 
current user. 
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1l.1»2e¢4% Pacameter_ Lisis_as Parameter Values 


Some SES procedures handie multi valued paraneters which are 
themselves parameter lists to be passed on to other procedures. For 
instances procedure FORMAT has a parameter calted prints which is 
actually the parameters for the PRINT procedures used by FORMAT in 
the course of its run. You code the print: parameter of FORMAT tike 
this 3: 


seseformat myfites printzc=s2 


seseformat hisfiles printz(c=5,h2*final ers!) 


1.1.25 Parametec Keywords_as_ Procedure Ootions 


Some SES procedures have parameters that don't want any values at 
all. In these casess the parameter keyword {fs used to indicate 
QPTIONS for the procedure. For instarces oprocedure PRINT has a 
shift key (no pun intended)» which if codeds indicates that the File 
to be printed has not been formatted for a fine printer and must 
therefore be "shifted™ to the right by 1 column and have carriage 
contro! characters added in (the new) first cofunne. You use PRINT 
in such a case like 3 


seseprint fzanyfiles shift: 
and another exampie of options is GENCOMP (GENerate COMPile fileds 
where you can type 3° 
sesegencomp alls b=cidbases cfzcomfile 
in this cases the alt key indicates that al! nodules are to appear 


on the resuiting “compile file", 


Throughout the procedure descriptionss we use the word key to 
mean a keyword used to provide options to a orocedure.e 
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1.1.3 USING MORE THAN ONE SES PROCEDURE AT A TIME 


It's possible to use many SES procedures» f#ach one Following on 
right after the previous ones with no execution breaks between then. 
You do this by coding them all on the sane t!ines each procedure 
terminated by a semicolons like this : 


seseprint myfiles noshift; print hisfite shift; catiist. 


This example PRINTs myfite and doesn?t shift it (the noshift key)» 
PRINTs hisfile with carriage control added (the shift key)s and 
finally does a CATLIST of your files for you» 


1.124 ORDINARY CONTROL STATEMENTS ON A CALL TO SES 


It*s also possible to include regular ‘9S control statements on 
the same fine as SES procedure callss alt nixed togethers, like 
this 3 


seseprint myfile; treturnsmyfile*; *getshisfite"; format hisfile 


AS you can sees the ordinary NOS control statenents are enclosed in 
string delimiters just tike any other character stringe When SES 
processes one of these control statement striingss it follows the 
rule that 3: 


if the string doesn*t contain a period or a close parenthesiss a 
period is appended to the strings otherwise the string is teft 
alonee 


This means that you can place NOS contro! statenents such as GTR 
and MODIFY (which use the control statement comment field for 
directives) with no problems. For example : 


sesetattachsplocrib'; *gtrsptlocribsfred.*'$ print fred 


In this examples the second NOS control statenents namely the GTR» 
has a period in its so SES doesntt place any neriod at the end of 
the strings whereas SES does place a period at the end of the first 
string (the ATTACH statement). 
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12125 CONTINUING SES STATEMENTS QVER MORE THAN ONE LINE 


SES can handtle continuation lines (even when youtre using SES 
interactively)» for those cases where you can't specify all you want 
to on one line.w You Indicate continuation by olacina two or ~*more 
periods at the end of the tinee SES then asks for continuation 
fines to be typed ine For example : 


Jseseprint fz (snarks sharks charmeds quarkss es: 
ee? tarkss boojumss grogss banders snatchi) 


After you've signalied the incomplete fine by placing an ellipsis at 
the end of the tines SES prompts for a continuation line with a 2? 
at the start of each continuation line. The slash (4) before the 
ses on the first tine indicates where NS outputs [its prompt for 
commandse 


When you use SES in a batch job strean you simpty code the 
continuation tines one after the others each inconplete line having 
the ellipsis at the ends for example ; 


batch 
job 
statements 
SESeCOLLECT (CHENASs FLEURIEs MORGONs CORNASs TAVELs eo 
GHEMMEs SOAVEs ORVIETOs CAREMAs PARRINAs BAROLO) 
and more 


statements 
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401.6 PROFILE - SETTING UP YOUR LOCAL ENVIRINMENT 


A PROFILE is a file where you can place information about you and 
the things you're currentiy working one. Many SES procedures use 
information out of the PROFILE to set up defautts for frequently 
used things» such as the name of an object library. Having a 
PROFILE can save you much time since you dontt have to code 
parameters for Information that's already In the profile. 


If you want to have a profiles you should create a file called 
PROFILE which has the word PROFILE as the first tine of the file. 
The most important and useful pieces of information to place in your 
profile are your password» charge oumber and orcoject number. Thus» 
your initial profile should have (at teast) the following in it: 


PROFILE 

\ passwor = *your_password? 

\ charge = your charge _nunber? 
\ project = *your_project_nunber?t: 


An easy way to set up an initial PROFILE for yourself is to call 
the BuilD PROFile (BLDPROE) procedure tike this 3: 


ses.bidprof 


BLDPROF prompts you for the most common items to be placed in your 
profile. In additions it creates a MAILBOX for = youe For 
information on the "mail™ facilities of SES» see the chapter on 
USER TO USER COMMUNICATIONS”, 


SES supplies a procedure calted IAFs which sets up defaults for 
particular terminal types. BLDPROF prompts for your terminal type» 
and places that information itn your oprofile. For further 
information on IAFs see the IAF procedure description in the 
"niscellaneous useful goodies" chapter. 


BLDPROF wilt atso ask you for your graphics terminal type which 
may be different than your usual terminal. Even if you use the same 
terminal for graphic (CADSG) and non-graphic works you should answer 
both requestse BLDPROF witt ask additional questions about your 
graphics terminal - baud rates hard copy avaitlables and _ (“for 
TEKTRONIX 4014 Extended Graphics Modute and synchronous or 
asynchronouse For further information on CADSGs see the CADSG 
procedure description in the Structured Process Tools chapter. 


There are many other things that may go into your profile. These 
are mainly concerned with source code naintenance and library 
management functions and so one These other asoects of profiles are 
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discussed in the chapters dealing with the svecific subjects. 


Another useful thing that can go into a profite is SES directives 
that specify which procedure tibrariess and wheres to search for 
procedures. The SEARCH directive is discussed in the appendices. 
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121-7 SES PROCEDURES RUN AS BATCH JOBS 


Instead of running interactivelys or “while you: wait" at your 
terminal, many SES procedures can be submitted to run in the 
background as batch jobs. You do this by coding a key (batch or 
batchn or defer) which causes the framework of a hatch job to be 
built around the specified procedures then SUBMETs the file so built 
to NOS as a batch job. 


Using SES in this way is often very effective, especially where 
the job to be done uses lots of resourcese Ry running the job in 
batchs you can proceed with your interactive session instead of 
having to wait. 


For such proceduresy the tist of parameters described below are 
those which affect the running of the batch job. Note that these 
parameters are only applicable if you run the orocedure in batch 
mode (that is» non-local). 


jobun ; 

(optional) JOB User Name to be used on the USER statement 
of the batch job. If you don't code the jobun parameters 
the job is bullt with the user name of the current user. 
Note =: that in some NOS sitess it is not possible to 
SUBMIT a job to run under another userts account. The so 
called “secondary user" statment is disabjed. If 
secondary user statements are disableds and you try to 
submit a job for another accounts you get logged off! 


jobpw : 
(optional) JOB PassWord to be used on the USER statement 
of the batch job. If you don't code the jobpw parameters 
and there's no passwor variable defined in your profile 
{see the section on profites)» SES asks you for your 
password in a similar manner to that of NOS. 


jobfmiy : 
(optional) JOB FaMiLY to be used on the JSER statement of 
the batch job. If you don*®t code the jobfmty parameter» 
and there's no family variable defined in your profile 
(see the section on profiles)» the family name for the 
current user is used. 


joben ;: 
(optional) JOB Charge Number to be used on the CHARGE 
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jobpn : 


jobfi : 


jobti 


oe 


jobpr : 


bin 3: 


statement of the batch job. If you don't code the jobcn 
parameters, and there's no charge variable defined in your 
profile tsee the section on profifes)s SES asks you for 
your charge number. 


(optional) J0B Project Number to be used on the CHARGE 
statement of the batch job. If you: dontt code the jobdpn 
parameters, and there's no project variabie defined in your 
profile (see the section on profites)s SES asks you for 
your project number. 


(optional) specifies the JOB Field Length to be used for 
running the job. You don't nornalftvy need to code the 
jobfl parameter, since ali the procedures which run in 
batch set the FL to the required value. If you want to 
specify the job fieid length as an gctal> numbers you must 
add the (8) suffix to the numbers because SES treats 
numbers as decimal unless told otherwise. 


{optional) specifies the JOB Tine Limit to be used for the 
job. This is always the same for’ all oroceduress» namely 
2000(8). If you need more time for the jobs you must code 
some vaiue for the Jjobtt parameter. If you want to 
specify the job time ftimit as an getal numbers you gust 
add the (8) suffix to the numbers because SES treats 
numbers as decimal unless told otherwise.! 


(optional) specifles the JOB PRiority (that iss the P 
parameter on the NOS job statement)... If you want to 
specify the job priority as an agctal nunbers you must add 
the (8) suffix to the numbers because SES treats numbers 
as decimal untess told otherwise.’ 


(optional) BIN number parameter used at sites atlowing bin 
references to indicate which "bin" the job output should go 
ine The bin parameter is codet in the form of a string» 
for example : bins*7h*. You can also define a userbin 
variable in your PROFILE (see the section on profiles)s so 
that the bin number is picked uo automatically. SES 
generates a targe print banner of your bin number on the 
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front of the job outputs, and also places the bin number in 
the job name Field of the job statement. If you dontt code 
the bin parameters and there's no userbin variable defined 
in your profiles SES generates a bin number of NO-ID» which 
almost certainly guarantees that your job output ends up in 
the NOS/WO BIN NUMBER bin. 


focal or batch or batchn or defer : 

coding one of these (optional) keys deternines the mode in 
which the procedure or job is to be rune. Coding the local 
key runs the procedure LOCAL to your terminals or while 
you wait. Coding the batch key issues a SUBMIT with 
option 8 for the SUBMIT statement. Coding the batchn key 
Issues a SUBMIT with the N ootion for the SUBMIT 
statement. Coding the defer key DEFERS the job for after 
hours runninge You can find all of the details of the 8B 
and N parameters for SUBMIT in the NOS reference manual. 


nodayf or dayfile or df ;: 

this (optional) parameter aopifes to some of the 
procedures that can be run as batch jobs. Each procedure 
description (for procedures which can run as batch jobs) 
specifically mentions this parameter only tf the procedure 
makes use of it. For those procedures that do use its 
this parameter applies onty if the procedure is run as a 
batch job (that iss non-tocalt). If you don't code the 
parameter at alls or if you simoly code dayfile or df» if 
the job hits an EXIT statement due to errorss the job 
dayfilte is dumped to a file catted dayfites which is 
placed in your catalog when the job terminates. If you 
code dayfitesfilename or dfz#filenames the dayfite is 
placed in your catalog in a file of name filename. If you 
code the nodayf options no dayfile is produced at job end. 
The diagram below provides a mor® graphical expianation of 
the interactions of the dayfile oarameter,. 
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H Coded Qn 


3 
tJ 


Procedure ; Action Taken. ; 
se Sa 0 A RC HE HN sD te OD wen ens ee he ee ee ce a a AE OO NO ON MO a en ee saw cane Sp 
Nothing i} Job dayfile is dumped to file dayfite if any 3 
; errors occur during the job. ; 
a A a A A AS A NO NE LH ee ee A A A HS A A ON A A SS a ND es mee ee 
dayfile or H 
df key ; 
only : Job dayfiie dumped to File dayfite if any 
$ errors occur during the job.e. 


dayfile=file name ; 
or dfzfilte_name § Job dayfile dumped to File fif'e_name if any 
errors occur auetng ie fobs 


> oe we we tH ae oe ee we 


Job dayfile is sae duaped™ even it errors $ 
$ occur during the job. ; 
+ 


nodayf kay 


Pe, a ee ee ee ee 


Note : that onty those procedures whose deserintions contain a 
reference to the parameters described ahove can be run as batch 
Jobs. 


Exampie of Batch Usage 


A fairly widely used SES procedure is LISTMO0 (which supplies = a 
cross reference and a printout of the modules In a base ~ see the 
chapter relating to source text maintenance). LISTMOD runs "while 
you wait™ by defaults and since it grindss it's nuch better to run 
it batchs like this : 


seselistmod bznewdatas batch 
15200219. SUBMIT COMPLETE. JOBNAME [S AFTQBXT 
REVERT. JOB LISTMOD SUBMITTED 


This example shows a simpie usage of LISTMI) run in batch by coding 
the batch key. The example assumes that your passwords charge 
numbers project number and al! are defined In your PROFILE as 
described eartier. The message is returned by NIS 3: It's the time 
of day that your job was submitteds and the so called job name. The 
fast message about job submitted comes fron SES.) 


1-22 
COC - SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
1.0 PREFACE | 
121.2721 PROFILE Variables for Controlling Batch Mode 


lelo7e1 PROFILE Variables for Controlling 3atch Mode 


SES procedures that can optionally run in batch mode may be 
controlled by the settings of certain variables in your PROFILE. 
This makes it easier to use SES all rounds since you don?t then have 
to supply the information every time you use a procedure. The set 
of directives below can be coded into your profite if you wish. 


PROFILE 

\ passwor = tyour_password? 

\ charge = "your charge number * 

\ project = *your_project_number! 
\ family = *your_family?* 


passwor defines your password 


charge defines your charge number. 


project defines your project number. 


family defines your family name. 


Note : that if your validation on the systen is such that you do 
not require a CHARGE statement In batch jobs or when you tog in at a 
terminals, you should set the charge and project variables to null 
(empty) strings. This inhibits the generation of the CHARGE 
statement by SES for batch jobs. 


1-23 
CDC - SQFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: GA 
1-0 PREFACE 
lelw~721 PROFILE Variables for Controtiing Batch Mode 


Examples of PROFILES 


PROFILE 

\ passwor = 'ASTERIX! 
\ charge = *OBELIX® 
\ project = "GETAFIX® 


That is an exampte of a minimal PROFILE. Yerets a typical PROFILE 
as it might be defined for a user 3 


PROFILE 

\ passwor = 'WABBIT! 

\ charge = *#? 

\ project = tt 

\ myname = tLorenzo Desmondo Of*Haret: 


Note that the charge and project variabtes are set to empty strings 
-~ this would apply to sites that dontt require CHARGE statements on 
NOS. 
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12128 INFORMATIVE MESSAGES FROM SES PROCEDURES 


Many SES procedures are set up such that when they run "while you 
wait" at the terminals they output informative messages to tell you 
what they're doing. The informative messages are controlled by msg 
and nomsg keys on the appropriate procedures. The normal defaults 
in the absence of any other information is for the procedures to 
output informative messages. Coding the nomsg key suppresses the 
messages. However, it is possibile to establish your own defauvuit by 
defining a profile variabie catied msgctr!. The msogctri variable 
can be defined in one of two ways : 


\ msgctrio = tx! this sets the nornal default for informative 
messages to no messages. In order to obtain 
messages from procedures the msg key must be 
coded on the procedure call. 


\ msgctri = *SESMNSG.*! this sets the nrornal default to output 
informative messages. To turn messages off» 
the nomsg key must be coded on the procedure 
call. 


The table below should give a more ogranhica! idea of the 
interactions of the msgctrl variable and the msg and nomsg keys on 
the procedures. 


: DEEINED IN PROEILE : 
$n nf fn mf a nf en we een tf 
+; Coded Gn :! Nothing i: V MSGCTRL=*SESMSG.*? § \ MSGCTRL=tx?) § 
+ Procedure 3 : : : 
$n ee ee nf fa en a nf en rn a nf oo ee 
; Nothing :: Messages } Messages H No Messages : 
ee $ $n rw en an f nn nn nf oe en + 
; MSG 3: Messages $ Messages H Messages H 
$e ee ee ee me i me a ef nf ee ee enn tt 
+; NOMSG : No ; No Messages No Messages $ 

% 


4 
a 
+: Messages } : ’ 


\ 
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1.129 GENERAL NOTES ON SES PROCEDURES 


SES procedures ares in generals written to do the detail work for 
yous,’ 50 you can concentrate on the job at hand. Letts look at the 
workings of a typical SES procedure - ¢3PY ASSII Coded Record 
({COPYACR)» to see what it does 3; 


sesecopyacr izinput files ozoutput_file 
REVERT. END COPYACR INPUT_LFILE -> QUTPUT_FILE 


The COPYACR procedure emits NOS controt statements to do the 
following : 


acguice the input_file (see the note orn ACQUIRE helow) 
acaguirce the program (tool) that does the COPYACR process 
cetucn the output _file 

COPYACR from input file to output _file 

ceturn the COPYACR program 

cewind both the input file and the outout_ file 


you may if you wishs use procedures such as COPYACR like this : 


sesecopyacr file to _be_processed 
REVERT. END COPYACR FILE_TO_BE PROCESSED 


In such cases» where does the output of the procedure go? Well it 
certainty doesn't go to file output (the terminal). In such cases,» 
the output file eventuatty replaces the inout Fite 3: 


acauice the file_to_be_processed 

acaguire the COPYACR program (tool) 

COPYACR file_to_be_ processed to a uniaue_named_temp_file 
ceturn the COPYACR program 
* rename file_to_be_processed = unique named _tenp_File 
return unique_named_temp_file 


There are many SES procedures that function this way - they = are 
often referred to as FILTERS - a process that copies an input to an 
output with some transformation in between. 
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ACQUIRING EFiles_in SES. Procedures 


When you call up an SES procedure to ; 
sese.do_some_process izinput_files ozoutput_ file 


one of the control Statements emitted by the erocedure is a 
statement to ACQUIRE the input_files which neans: 3 


le if there's a LOCAL file of the required names REWIND that file 
and use it as the input_file. 


2e otherwise ATTACH or GET a permanent file of the required name 
from the current user's catalog. 


Att this means you dontt have to care whether or not files are 
local —- SES procedures grab whatever is available under that name - 
that is what ACQUIRE is all about. There is a full description of 
the ACQUIRE utitity in the Appendix. 


The foregoing has some interesting effects which you should be 
aware of however. Consider the following sequence 3 


sesefiles; catlist 
WORKe ee e2el2 PT. 
CATLIST OF WCN ( 9 FILESs 2685 PRUS ) 
MAILBOX I SP A eeel OLDUSER D PU R 1127 PNTSORS D PU R 2.105 
PROCLIB D SP R .124 PROFILE [ PR R ose) PROGLIB D PU R .835 
SEVENe. I PU R eee2 STATSES D PU W 485 USERDIR I PU R 0005 
REVERT. END CATLIST 


sesepack izstatses 
REVERT. END PACK STATSES 


sesefiles 
WORKese eo202l2 PTe STATSES 22481 LOe' 
REVERT. END FILES 


Note that we PACKed file STATSES. Note that origqinaltys, STATSES 
was a PERMANENT DIRECT ACCESS file. By the time the PACK process 
finished howevers the PACK procedure (because of the RENAME process 
described earlier) has now teft a LOCAL fille of the same namee SES 
Procedures don'ts in generals rewrite permanent files. Those that 
do say so explicitty. 


1-27 
COC —- SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: 4A 
1.0 PREFACE 
1.21.9 GENERAL NOTES ON SES PROCEDURES 


Using SES. Procedures_in._ Batch 


If you followed the description of the behavior of SES procedures 
above» you may take note that SES is designed primarily as an 
INIERACIIVE too!. You gan use SES in batch job streams if you wishs 
but you should be aware that SES procedures don'ts in generals make 
a special case of files JNPUT and QUIPUT» «whereas NOS does make a 
special case of files [INPUT and QUIPUT. Usuattys when using SES 
procedures interactivelys you don't use QUIPUT as the output file 
from procedures,» those procedures that go us2 INPUI or QUIPUI say 
SO» and take special note of those files. At this means that if 
you run SES in batch streamss and use files INPJT or QUIPUT as input 
or output to proceduress you're tikety to tose ae fot of output 
because SES procedures REWIND or RETURN things. Sos to avoid griefs 
uses files other than INPUT and QUIPUT. 


Unique Names_in_SES procedures 


When SES builds the JCL stream from an SES oerocedures programs, 
scratch files and so on are usually given unique namess so that you 
don*t have to care which names are reserved by each particular 
procedure. These SES generated unique names are aiways seven 
characters tongs always begin with the ftetters ZQ, and are always 
guaranteed to be different from the nane of any file currently 
assigned to the running jobe This note ts: for your informations 
just in case you ever look at a dayfile where SES procedures have 
been useds and see lots of funny looking names. The example betfow 
Shows the JCL generated by the seselimits procedure. 


$RFL( 20000) 
SIFECFILECOUTPUTsAS)sLABEL1) 
$SRENAME (ZQWT8Q620UT PUT) 
SENDIFCLABELI) 

SASSIGN(MSs OUTPUT) 

SLIMITS. 

$RENAME (ZQWTSQQ20UTPUT) 
SIFECFILE(ZQWTBQ6sAS)LABEL2) 
SRENAME (OUTPUT=ZQWT8Q6) 
SENDIFCLABEL2) 

SREWIND (ZQWTSRA) 

EDT (ZQWT8QQ5ZQWTSRAsZQWTSRW) 
SRETURN(ZQWT8RA»s ZQWTBRW) 
SCOPYBRCZQWT8QQ,0UTPUT) 
SRETURN(ZQWT8QQ) 
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$RFLCO) 
REVERT. END LIMITS 
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1.21210 PROCEDURE DESCRIPTION CONVENTIONS 


The remaining chapters of this handbook describe SES oerocedures 
that are currentiy available. Each procedure description contains a 
list of parameter descriptions; and the order in which the 
parameters are described specifies their oositional significance 
within the procedure. 


Oniy those procedures that make references in their parameter 
listss to the “batch job parameters” (see the section calted "SES 
PROCEDURES RUN AS BATCH JOBS") can in fact’ be run as batch jobs. 


If a procedure description does not contain a description for a 
parameter, that procedure does not have such a oarameter. 


If a parameter description does not exolicitiv specify that a 
Parameter is optional then the parameter must be supotied when the 
procedure is called. 


In order to reduce redundancy within procedure descriptionss some 
of the features provided by a procedure are discussed in the 
descriptions of particular parameters; therefores we strongly 
recommend that when you read a procedure descriptions you read the 
whole thing. 


Before you read a particular procedure descriptions we strongly 
recommend that you read the introductory subsection of the chapter 
containing the procedure description. Such things as general 
parameter descriptionss profile usages and naming conventions are 
discussed in those subsections. 
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Lels11 PARAMETERS TO THE SES PROCESSOR 


You: have just read about parameters for’ SES procedures in the 
first sections of this chapter. You can atso orovide parameters to 
the SES processor to direct it's actions. These parameters come 
after the SES» and before the .»procedure_nane.e These parameters may 
be specified in order dependent or keyword nanner. 


Llele1ll.1 UN 


The UN parameter specifies the catalog containing the requested 
procedure. For examples if a procedure is in the SESPLIB library on 
cataiog TEAMs just type SESsUN=TEAM.procedure name to use it. See 
also Appendix A. 


1.1e1i-2 LPEN 


The LPFN parameter specifies the library permanent file name of 
the SESPLI8 containing the requested procedure. If the library iis 
on another catalogs both the UN and the LPFN varaneters are needed. 
For examples 
SES »sUN=TEAMsLPFN=PROJLIB.procedure_name 


gets the procedure from tibrary PROJLIR on catalog TEAM. See 
Appendix A for more information about accessing procedures. 


lele11+3 PUN 


The PUN parameter specifies the catalog containing the PROFILE 
you wish to use. See Appendix A for additional detaits. 


Lelei1.4 P 


The P parameter gives the name of the PROFILE File you wish to 
use@e See atso Appendix Ae 
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1.1.11.5 DUN 


The DUN parameter is a default catalog that contains the user 
files needed by the procedure being called. For examples 


SES» DUN=TEAM.PRINT TESTFEIL 


will Print file TESTFIL from catalog TEAM.! This parameter is 
generaily used with the DPN parameter. 


1.1.11.6 QPN 


The DPN parameter is a default packname that contains the user 
files needed by the procedure being calted. This parameter allows 
you to maintain your files on a private pack: and still use them with 
SES. 


1.1.,11.7 Processor Qoerating Mode Parameter 


The next parameter determines the operating mode of the SES 
processor. 


The SES processor processes procedures In one of four modes : 


RUN This is the normal mode. The orocedure is processeds 
presumably generating contro! statenentss and then these 
control statements are executed, 


TEST In this mode the procedure is processed in the normal 
manners but the generated controft statements are not 
executeds instead they are placed on a designated file for 
possible inspection by the user. This mode is meant as an 
aid in debugging new procedures. 


HELP This mode is similar to test modes however instead of 
generating contro! statementss a procedure set up for HELP 
mode produces some documentation on it's purpose and usage. 


STATUS This mode is simitar to test modes however instead of 
generating control statements, a orocedure set up “For 
STATUS mode produces any change Information available about 
the procedures 
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Refer to Appendix B for additional information on these modes. 


Lelell.7.-1 RUN 

This is the normal operating mode of the processor and is the 
default mode. The specified procedure is orocessed and executed. 
It is normaily not necessary to specify rury as the mode. 


1.1.211.7.22 JEST 
The TEST parameter tells the SES processor to execute in TEST 


modes In this modes, the procedure itis orocessed in the normal 
manners but the generated control statenenrts are not executed. 
Instead» they are placed on a designated fite for possible 


inspection by the user. 
SESsTEST=myfiie.procedure_nane 


will place the generated control statements on file myfile. If no 
file is specifieds SESTEST will contain the control statements. 
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1212112723 HELP_OR_H | 

The HELP parameter tettis the SES processor to execute in HELP 
modes SES provides a mode of operation of orocedures that produces 
descriptive information about the specified procedure. The 
information inctudes a one or two sentence description of what the 
procedure does plus a list of the parameters, their defaults», and 
the permissable values. In additions, required parameters are 
"fiagged" with (R) and defauits that are controtiabie by PROFILE 
variables are "flagged" with an *. To get the help documentation 
for a procedure listed out on your terminals you: simply type 3; 


sesshelp.procedure_nane 


Notice that no parameters are given. SES responds by displaying the 
help documentation for the named procedure (if any is avaitabte). 
For example 3 

ses, heip.getmod 
produces : 


GETMOD extracts 1 or more modules (decks) from a MADIFY base 

library and places thems in MADIFY source formats on a group file. 
Parameters are? 

am—-P AR AMET ER--—--DEF AUL Tenn nnn ALLOWABLE: VALUES ) nnn enn nn nn nn nn we 


(R) msall none MADIFY decknamne(s) (ranges allowed) 
gs group *group filename 
bs *base Filename 
un *current user username 
corssc none filename 
widthsw madify numeric naximum width of retrieved deck 
statusssts none keyword 
mS ganomsg *msg keyword 


~HELP FOR GETMOD ON FILE OUTPUT- 


SESsHELP=myfile.eprocedure_name will place the help documentation 
on File myfile. 


Note : that help mode is not intended as 4a training mechanism or 
a tutorial for new SES users - that's what this SES User*s Handbook 
is for - help mode is there as a "memory jogger" for more 
experienced SES users. 
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1.1211-27-4 STATUS_OR_S 

SES provides a STATUS mode of operation that tists current status 
information about the specified procedure. Changes to SES 
procedures that potentially affect users are communicated in this 
manner. To get status information on a particular procedures you 
simpty type : 


sessstatus-eprocedure nape 


Status items are listed in reverse chronological order. Ali changes 
affecting the procedure since the previous SES Release are tisted-. 
For example 3: 

sessstatusegencomp 
could produce : 


02/09/82 

The field length vatue used by GENCOMP has been increased to 
77700(8) to accommodate iarger program libraries. 

STATUS OF GENCOMP ON FILE OUTPUT 


SESs STATUS=myfile.procedure_name will) place the status 
information on file myfile. 


1-35 
CDC — SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User*s Handbook REV? GA 
120 PREFACE 
1.1212 PRE-RELEASE VERSIONS OF TOOLS 


Llelel2 PRE-RELEASE VERSIONS OF TOOLS 


SES provides a convenient and consistent nethod for accessing 
pre-release versions of SES supplied tools. To access the 
pre-release version of a procedures you sinolty type : 


sessssseprocedure_name ftist lof parameters 


If there is a pre-release available for the specified tool» it 
executes. If there is no pre-release versions you get the standard 
release versions 


If you always want pre-release versions of tools that are 
available, you can place in your PROFILE the following directive : 


\ SEARCHs USER» SSS» SESUNAM 


This teils SES to first look in the currant user's catalog for the 
specified procedure (just as normally hapoens)s then took in the 
pre-release catalog (SSS)» and finally look in the standard release 
catalog (specified by the SESUNAM variablie). 


A more detailed description of the SEARCH directive can be found 
in the Appendix. 
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121213 PROBLEM REPORTING 


Problems encountered while using a released SES tool should be 
reported using a PSR {Programming System Reports CDC form AA1901). 


Problems encountered while using a pre-released SES tool should 
also be reported using a PSR (Programming Systen 2enorts, CDC Form 
AA1901). 


The completed form atong with alll support materiais should be 
sent to the Arden Hills PSR Coordinator (A24239).. 
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161.14 APPLICABLE DOCUMENTS 


SES provides a procedure called TOOLDOC which provides "“on-line® 
access to many SES documents. If you call TIOLDOC without giving 


any pacameterss you get a Jist of the available DCS documents. 


The following CDC manuais for NOS/170 may be of help to users 


SES. 

60455280 CYBIL Reference Manual 

60457286 CYBIL Language Specification 

60457290 CYBIL Handbook 

60457260 NOS DEFINE Data Dictionary Tools User's Handbook 

60457270 NOS GRAPH Graphics User's Handbook: 

60435400 NGS Version 1 Reference Manual (Votfumne 1) 

60445300 NOS Version 1 Reference Manual (Volune 2) 

60455250 Network Products Interactive Facility Version 
Reference Manual 

60435500 NOS Version 1 Time-Sharing User's Reference Manuai 

60450100 NOS Version 1 Modify Reference Manual 

60492600 COMPASS Version 3 Reference Manual 

60328800 SYMPL Reference Manual 

60497800 FORTRAN Extended Version 4 Reference Manual 

60481300 FORTRAN Version 5 Reference Manual 

60429800 CYBER Loader Version 1 Reference Manual 

60481400 CYBER Interactive Debug Version 1 Reference Manual 
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2-0 SES. PROCEDURE LIBRARY MANAGEMENT 


SES supplies a separate set of orocedures to nanage SES procedure 
libraries. These tibraries are in a unique format that is 
incompatible with other library management orocedures provided by 
SES3 @eges REPMEM. SES procedure tibraries are always maintained in 
sorted order. The terminology that these tibrary management 
procedures use are as follows ; 


LIBRARY A coltection of SES procedure records ona file. All 
SES procedure library managenent orocedures use an 1 
parameter to refer to a Library. 


PROCEDURE A singie record In an SES procedure tibrary files or a 
file containing a procedure which is added to or 
replaced on a tibrary. All SES procedure library 
management procedures use ap oarameter to refer to 
PROCEDURES. 


GROUP a coliection of procedure(s) that occupy one record 
per procedure on the file. 
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Summary Of SES Procedure Library Management Procedures 


GETPROC 


REPPROC 


CATPLIB 


LISTPROC 


WIPEPROC 


GET PROCedures gout of a library anto a group file. The 
procedures appear one per logical records 


REPlace or add PROCedures on a Yibrarye You also use 
REPPROC in a special way to create a brand new library 
from scratch. 


CATatog a Procedure LIBrary to disotay the names and the 
types of procedures in the librarys in short form output. 


LIST PROCedurese LISTPROC generates a catalog of all the 
procedures on a library» and optionally prints every TEXT 
procedure from the jiibrary. 


WIPE (delete) PROCedures from a library.) 
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Parameter Naming Convention for_ SES Procedure Library Management 


This section introduces the parameter nraning convention that's 
common to most of the procedures in the procedur’e library management 
system. 


1 or b name of Library on which the overations are to be 
performed. 


p stands for Procedure({s). 


g or group. name of file upon which a GROUP of procedures are 
accumulated when adding or replacing procedures on a 
librarys or when procedures are extracted from a 
library. A group file contains one procedure per 
logical record. 


nioor nb name of a New Library or New Bases used in those 
procedures that perform operations that permanentty 
alter a tlibrarys requiring that a new library be 
created. An explanation of the method used to update 
a Yibrary is contained in a subsa@quent section. 
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PROFILE Variables for SES Procedure Library Managenent 


The variables described betow may be dectared in your PROFILE in 
order to establish default information for the oarameters of the 
procedure library management procedures. 


plib name of procedure ftibrary where procedures are to be found 
or replaced. 


plibown user name in whose catalog the procedure tibrary is to be 
Found. 


newplib name of new procedure fibrary for those orocedures which 
update a tibrarys thereby creating a new one. The default 
name for newplib is the same name as the ofd tibrary. 


group used by ali procedures to designate a group fiies or a file 
containing one procedure per togical record. The default 
name for group is group. 


sestmpp used by ail of the procedures that update procedure 
libraries to specify the temporary ltibrary file during the 
update processe The defauit name for this file is sestmpp. 


fokmode determines the interlocking action when updating a 
procedure library. The tokmode variabte may be set to 
"LOCK? {tock by default untess the nolock parameter is 
coded on the procedure) or *#NOLOACK* (no tock by defautt 
uniess the tock parameter is coded on the procedure). 


intriok used by alf of the procedures that update procedure 
tibraries to specify the interlock fite to be used during 
the update process. The default name for the Interlock 
file is intrlok. 
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SES_Procedure Library Vodating Process 


Some of the procedure library management procedures physicaily 
alter a tibrarys, requiring that a new library be created. The 
process is common to all such proceduress and is as follows 3 


If you code both the { and nf parameterss the new procedure 
library is created simply by performing the required operations on 
the old fibrarys and writing the newly created tibrary onto the file 
specified by the nl parameter, 


If you code only the t parameters the uodate takes place in two 
stages.» The updating operation is performed and the new ITibrary 
written to a file called sestmpp (SES TeMPorary Procedure). sestmpp 
is then physically copied back over the fila specified by the 1 
parameters and finally sestmpp is purged. 


Note that if the file specified by the nt (or ! if nb is omitted) 
does not already exists a DIRECT access READ mode file is DEFINEd 
for the tibrary {(thiss of courses can onty be done if the owner of 
the Jibrary is the current user). 


Note that if anything goes wrong during an updating runs the 
original tibrary is always left intacts and only the new tibrary or 
sestmpp is potentially incorrect. This means that you can recover 
by purging the new library or sestmpp and starting the run again. 
If something goes wrong before the IJibrary appears on sestmpps 
original tibrary is intacts and sestmpp nay be ourgeds whereas if 
something goes wrong after the new library is on sestmpps that is» 
during the "rewrite" phase of the updates it is sestmpp that is 
safes and the oid JVibrary that is wronge In this cases you may use 
the REWRITE procedure to do the rewrite agains or alternativelys you 
may just purge the old ltibrary and then change the name of sestmpp 
to be the library name. 
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ioterlock Process for Vpdating a Library 


When updating a library you can interlock the uodate so that only 
one user at atime can update the tibrary. Those procedures that 
update a library are set up so that if the library to be updated is 
in another user'!s catalogs, the library is: interlocked by default. 
You can override default actions by defining a lokmode variablie in 
your profiles or by coding a tock or nolock: kay on the procedures as 
shown in the diagram on the next page. 


Interiocking of a tibrary is done via an interlock file. Such a 
file must be a DIRECT access file in the sane usects catalog as the 
library being updated. Naturally the interlock file must be a 
PUBLIC,y, WRITE MODE file if other users are likely to be using it. 
The default name used by the SES source code naintenance and tibrary 
Management procedures for the tock file is tntrlok. You can have an 
interlock file of any name by defining the intriok profile variables 
or by coding a file name as a value for the tock: parameter on the 
appropriate procedures. 
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+ Coded Qo : : ae : 
: Procedure } Action Taken i 
: lock i library or base igs locked regardless of contents of i 
3 + tokmode profile variable or other conditions. : 


i; notock ; library or base is not focked regardiess of contents $ 


H +} of fokmode profile variable or other conditions. H 
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: Nothing : Coded in Profile : Action Taken ; 


ee eee ct cee ee ce ae ef re ee ae ee ee ee eee ee ae ee ae ew ee eet fp A a en ane sa ene a Sp 
\ fokmodes*LOCK* i tibrary or hase is locked 
; unless overridden by notock 
{ parameter on procedure. 
\ ftokmode="NOLOCK* { ftibrary or base Ls not tocked 
i; uniess overridden by lock 
; parameter on orocedure. 
ae ee ee ce see ae see ee he oe ee ee ee a ane ae ee ee ce ee ee ee ee ce ae oe ee ae ee ae ene a ee 
: + Dwner Of Base ; : 
+ Nothing : Or Library ; Action Taken : 
$n wn nw fo wn wm fn wn nn on on ef 
; Current User i ttor’ary or base fis not 
locked unless the lokmode 
orofife variable is set 
to 'LOCK*® or the tock 
parameter is coded on the 
procedureé.: 
library or base is tocked 
untess the lokmode 
orofile variable is set 
to 'NOLOCK® or the notock 
; Parameter is coded on the 
: Orocedure 
Pe oe ee ee ee oe ae ee ee he ae ee et ne ee ee ee ee ee ee ee ee 
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Another User 
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201 GETPROC =~_EXTRACT PROCEDURE(S) EROM PROCEDURE LIBRARY 


GETPROC 
a SES 


is intended for extracting any number of orocedures from 


procedure tibrary onto a group Files with one procedure per 


logical record. Parameters to GETPROC are 3 


p or 


g or 


proc or ali 3: 


If you code the all keywords SGETPROC extracts ALL 
procedures from the procedure ltbrary specified by the t 
parameter. Otherwises you code the » parameter as a tist 
of name(s) of Proceduret{s) to be extr’'acted. Ranges of 
procedure names may also be coded» as shown in the 
exampfies at the end of this descrinotion. 


group : 


b 


2 
s 


(optional) name of group file to receive the procedure(s) 
extracted from the procedure library. If you don't code 
the g parameters GETPROC uses the vatue of profile 
variable groups and if there's no such variabie defined, 
uses the name group for the group file. 


{optionat) name of procedure Library from which the 
procedure(s) are to extracted. [f you: don*t code the } 
parameters, GETPROC either uses the vatue of profile 
variable plibs or if that's undefineds GETPROC uses the 
name plib for the name of the procedure tibrary. 


(optional) User Name in whose catalog the procedure 
fibrary specified by f is to be founds ff it isntt in the 
catalog of the current user. If you don*t code the un 
parameters, GETPROC uses the value of orofile variable 
Plibowns, and if there*s no such variable defineds the 
GETPROC uses the user name of the current usere 


status or sts ; 


status is an (optional) key used for those cases where 
GETPROC is being used as a building block of more 
sophisticated procedures or jobs. The status parameter 
causes GETPROC procedure to set the job control register 
EFG to the value zero if GETPROC successfully completeds 
and non zero if anything went wrong during the run of 
GETPROC. If status is not quoted and an abnormal 
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condition occurss GETPROC willl EXIT. 


Examples of GETPROC Usage 


sesegetproc format tzesesplib unztr 77 
REVERT. END GETPROC GROUP <— SESPLIS 


The example uses GETPROC to get one procedure called format from 
a library catted sesptib in the catalog of user tr77. 


sesegetproc (txtcodestxtformstxthead) binary lteprgiib un=emv73 
REVERT. END GETPROC BINARY <= PRELTB 


This example extracts a group of procedures Fron an SES procedure 
library called prgtib in the catalog of user’ mv73 and places them on 
a group file called binary. 


sesegetproc (catiliste.changes compare..dayweek) tzsesplib 
REVERT. END GETPROC GROUP <— SESPLI8 


This example iilustrates how ranges may be coded for a parameter. 
The exampie extracts alii procedures catiist through change 
inctusives, and all procedures compare through dayweek iInclusives 
from an SES procedure tJtibrary called sesplibs and places the 
extracted procedures on the file called group... 
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2e2 REPPROC =_ADD_OR REPLACE PROCEDURECS) IN_PROC. L1Bs 


REPPROC is a procedure to add new procedureat(s) tos or repiace 
procedure{s) on an SES procedure tibrary. Parameters to REPPROC 
ares 


p or proc 3; 
(optional) ftist of file(s) containing Procedure(s) to be 
added to or replaced on the orocedure tibrary. If you 
don't code the p parameters REPPROS assunes that all the 
procedure({s) to be added or replaced are already on a file 
specified by the g parameter. 


g or group : 
(optional) name of a group file on which procedurets) are 
accumulated as one procedure oer ftogical record. If you 
dontt code the g parameter, REPPROC uses the vaiue of 
profile variable group. If there's no such profile 
variable defined, REPPROC uses Filenane group as the group 


file. 

tor b: 
(optional) name of procedure Library on which the 
procedure(s) are to be added or replaced. If you dontt 


code the 4 parameters REPPROC uses the vatue of profile 
variable plib as the name of the procedure tibrary. If 
there*s no such profile variable defineds REPPROC uses a 
fibrary name of piib. 


nipoor nb 3: 
(optional) name of New procedure Library to be created 
when REPPROC has completed its run» If vou don't code the 
ni parameter, REPPROC uses the value of profile variabie 
newplibs and if there's no such profifte variable defineds 
REPPROC writes the new procedure tibrary over the file 
specified by the # parameter. 


un 3 
(optional) User Name in whose catalog the procedure 
library specified by t/ntt is to be founds if t/ni is not 
in the catalog of the current user. If you don't code the 
un parameters, REPPROC uses the value of profile variable 
plibown as the user name from whose cataiog the procedure 
library is to be obtaineds and if ther’e*s no such variable 
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defineds REPPROC uses the current user'ts catalog. 


fock or notock : 

these (optional) parameters determine whether the base 
update process is intertocked against simultaneous updates; 
coding a filename for the tock ovarameter determines the 
name of the interlock file. I[.1terlocking is the default 
action when the base being updated is in another user's 
catalog. If you don't code either of the fock or nolock 
keys» interlocking is controlled by the tokmode profile 
variable. Refer to the Introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nofock parameters. If 
you don't code a filename for the tock parameters the 
contents of profile variable iIntritok is used as the 
interlock filename; if there*s no such profile variables 
the name fintriok is used as the tock filename. The 
interlock file gust be in the sane catalog as the base 
being updated. If the intertock fila cannot be founds the 
procedure aborts. 


batch job parameters : 
These parameters sre described in the section entitled 
"SES PROCEDURES RUN AS BATCH J988"%. The defauitt for this 
procedure is to run in focal modes but it can be run in 
batch mode. The dayfile parameter is not used by this 
procedure. 


msg or nomsg : 
these (optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEOURES*®. 
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Examples of REPPROC Usage 


seserepproc (firsts seconds third) txberkfib. 
* FIRST -> GROUP 

* SECOND => GROUP 

* THIRD -> GROUP 

* REPLACING/ADDING MEMBERS ON BERKLTS 

* LIBRARY NOW ON SESTMPP 

* NEW LIBRARY NOW ON BERKLIB 

* SESTMPP PURGED 

REVERT. END REPPROC GROUP => BERKLTIB 


This example ittustrates REPPROC used to collect three procedures 
onto a group files and then place the contents of the group file on 
an SES procedure tibrary calied berkfib. The exampte shows some of 
the informative messages that appear during a REPPROC run. 


Creating a New Library with REPPROC 


seserepproc nizsesptlibs g=sneuproc 
* CREATING NEW LIBRARY PROCLIB 
REVERT. END REPPRGC NEWPROC => PROCLIB 


This exampte fttitlustrates how to buitd 3a new SES procedure 
library. The new procedures to be added are on a group file called 
newproc. 
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203 CAIPLIB_=_PRODUCE LIST_QE PROCEDURES IN A_220Ce. LIBs 


CATPLIB is used to display a procedure tist of the procedures in 
an SES procedure tibrary. CATPLIB outputs the procedure tist in a 
condensed formats five procedures per lines showing only the 
procedure names.e Parameters to CATPLIB area 3 


tor b: 
{optional) name of procedure Library which is to have its 
procedure names displayed, If you don't code the 1 
parameters CATPLIB uses the value of orofifte variabie plib 
as the name of the tibrarys and if there's no such 
variable defineds CATPLIB uses a File nane of plib. 


un 3 
(optional) User Name in whose catalog the procedure 
library specified by the ! parameter is to be found. if 
you: don?t code the un parameters CATPLIB uses the value of 
profile variabie plibown as the user names and if there's 
no such variable defineds CATPLI®8 uses the current user's 
catalog. 


(optional) name of file to receive the DOutput from 
CATPLIB. if you don't code the o parameters CATPLIB 
piaces the procedure list on file output. 
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sesecatpliib beseshiib un=mv69 


Exampte of CATPLIB Usage 


PROCEDURES ON SESHLIB PROCEDURE LIBRARY 


ANYMAILHLP 
CHANGEHLP 

DAYWEEKHLP 
DUMP9OSSHLP 
GENCPFHLP 

GETMAILHLP 
LIBEDITHLP 
NEWPSRSHLP 
REPMODHLP 

SES PARMHLP 
TMPFILSHLP 


USEINFOHLP 


XGENMARHLP 
REVERT. 


This example shows CATPLIB output for a library 


AS ORTHLP 

CHANGP FHLP 
DDCREATHLP 
DUMPPFHLP 
GENMARHLP 
GETMEMHLP 
LIMITSHLP 
NOWLISTHLP 


RE PPROCHLP 


SESPRGOCHLP 
TOSOOHLP 

US EMSGHLP 
XGENMSGHLP 


END CATPLIB 


catalog of user mv69. 


BANNERHLP 
COLLECTHLP 
DDDISHLP 
EDTHLP 
GENMODSHLP 
GETMODSHLP 
LINK17OHLP 
PACKHLP 
REPULTBHLP 
SIMDEFHLP 
TO9S9S9HLP 
VEGEEHLP 
XLITHLP 


HELPLIB -> QUTPUT 


BELLHLP 
COMPHLP 
DDHLP 
FSFORMHCLP 
GENMSGHLP 
GETPFHLP 
LISTMEMHLP 
PERMITHLP 
RETAINHLP 
SIMFNUNHLP 
TOOLDOCHLP 
VOLUMEHLP 
XREFMODHLP 


seshliib 


BOVLAYHLP 
COMPAREHLP 
DDMERGEHLP 
FILESHLP 
GENPDTHLP 
GETPROCHLP 
LISTMODHLP 
PERMPFHLP 
REWRITEHLP 
SPECTRHLP 
TWOPAGEHLP 
WHOMAILHLP 
PLIB DIR 


in the 
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20% LISTPROC = LIST CONTENTS OF PROCEDURE LIBRARY 


LISTPROC performs two main functions to show you what's in an SES 
procedure librarys and to get a printout of any number of procedures 
from the procedure library. LISTPROC first generates a tist of the 
names of all the procedures specified. Lastiys»s LISTPROC generates a 
printout of all procedures specified. Parameters to LISTPROC are : 


p or proc : 


optional) list of name(s) of Procedure{s) to be 
extracted. If you don't code this oarameters, LISTPROC 
extracts all procedures fron the procedure tibrary 


specified by the t parameter. Ranaes of orocedure names 
may also be coded. 


ior b: 
(optional) name of procedure Library to be processed. If 
you dontt code the b parameters LISTPROC uses the vatue of 
profite variabte plib as the orocedure ltibrary names and 
if there's no such variable defined» the LISTPROC uses the 
default name plib. 


o or output 3 

(optional) name of file to receive the Qutput from 
LISTPROC. If you don't code the o parameters tLISTPROC 
places the output on some untiqu2a fite name that it 
generatese The output doesn#t default to file output 
becauses if you're running LISTPROC Interactivelys, you 
probably don't want the rather voluminous output on the 
screene 


(optional) User Name in whose catalog the procedure 
library specified by ! is to be found. If you don't code 
the un parameters LISTPROC uses the value of the profile 
variable plibowns and if there isnt*t such variable 
defineds LISTPROC uses the user name of the current user. 


batch job parameters : 
These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH J98S". The default for this 
procedure is to run in batch modes but it can be run in 
focal mode. The dayfite paraneter fis not used by this 
procedures 
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print ; 
this (optional) parameter indicates hoa the output of 
LISTPRGOC is to be printed. For’ the print parameter you 
may code any of the parameters to procedure PRINT. IF you 
don't code the print parameter at: alls LISTPROC prints one 
{1) copy of the output on the ASCII orinter. 


msg or nomsg : 
these (loptional) keys control. the generation of 
informative messages by this orocsedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES®. 


Examples of LISTPROC Jsage 


seselistproc print=c=3 
12234256. SUBMIT COMPLETE. JOBNAME YS ACULARS 
REVERT. JO8 LISTPROC SUBMITTED 


This example shows LISTPROC used to orocess a tibrarys whatever 
name is the value of plib. Three copies of all the procedures are 
being produced. LISTPROC is being run in bhatechs rather than 
interactively. 


seselistproc bzsesplib ozprocs print=(cz=2sh="*fatest/sesplib!) 
18.2£12-00-. SUBMIT COMPLETE. JOBNAME IS ANAPABS 
REVERT. JOB LISTPROC SUBMITTED 


This example shows LISTPROC being run In batch to produce two 
full printouts of the contents and al? the orocedures in the 
procedure iibrary sesptib. The title on the listing is 
"latest sesplib*. 
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205 WIPEPROC =. DELETE PROCEDURE(S) FROM PQOCEDURE LIBRARY 


we 


WIPEPROC is a procedure for deleting (wioing) orocedure(s) from 
an SES procedure tibrary. Parameters to WIPEPROC are 3 


p or proc : 
fist of Procedures to be deleted from a procedure library. 
Ranges of procedure names may also be coded. 


{ or b : 
(optional) name of procedure Library from which 
procedure (s) are to be deleted.’ If you don*tt code the 1 
parameters WIPEPROC uses the vatue of orofilte variable 
plib as the name of the Iibrary. If there's no such 
profile variable defineds WIPEPROC uses the name pitib as 
the name of the procedure library,! 


nipoor nb ?: 

(optional) name of New procedure Library to be created at 
the end of the WIPEPROC run. If you don't code the nf 
parameter, WIPEPROC uses the value of profile variable 
newplib as the name of the new procedure tibrary. If 
there's no such profile variabt2 defineds WIPEPROC places 
the new procedure tibrary back over the old procedure 
library specified by the !? paramneter. 


un s 

(optional) User Mame in whose catatog the procedure 
library specified by t{/nit is to h2 founds if tnt is not 
in the catalog of the current usere If you dontt code the 
un parameters, WIPEPROC uses the value of profile variable 
Plibown as the user name from whose catalog the procedure 
fibrary is to be obtaineds and if there's no such variable 
defineds WIPEPROC uses the current userts catalog. 


lock or nolock 2: 
these (optional) parameters determine whether the base 
update process is interfocked against simultaneous updates; 
coding a filename for the lock: parameter determines the 
name of the interfock file.e Intertocktng is the defauyit 
action when the base being updated is in another user's 
catalog. If you don't code either of the tock or nolock 
keySs interlocking is controlled by the tokmode profile 
variable. Refer to the introductory sections of this 
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chapter for information on the interactions of the tokmode 
profile variable and the tock and notock: parameters. If 
you don't code a filename for the tock parameters, the 
contents of profile variable intriok is used as the 
intertock filename; if there's no such profile variables, 
the name intriok is used as the tock filename. The 
interlock file must be in the sane catalog as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


batch job parameters : 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH J085". The default for this 
procedure is to run in focal modes but it: can be run in 
batch mode. The dayfile paraneter is not used by this 
procedures 


msg or nomsg ? 
these loptional) keys control the generation of 
informative messages by this oerocedure and are fully 
described in the section entitled “INFORMATIVE MESSAGES 
FROM SES PROCEDURES*®. 
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30 PRINTING FILES 


This section covers the facilities for orinting files. Most of 
the discussion revolves around the AS*TII printers and the SES 
procedures to use the ASCII printer are as described below 3: 


PRINT prints filets} on the ASCII printer (the "“"normal™ CDC 
printer is an option). If necessary» "carriage contro!" is 
added to the files before printing (it is possible to 
override this automatic determination but it is very seldom 
necessary to do so). Choices of character sets (full ASCII 
or the 64 character ASCII subset) are available. 


PRINTID ptaces “large print" heading banner’ at the start of a 
printout. Lines of titties date and time formatss and 
number of banners are selectable. PRINTID Is used by PRINT 
to (optionally) place large print banners at the start of 
the file(s) to be printed. 


COPYSAF COPY Shifted ASCII Eite. Copies an ASCII file to prepare 
it for printing at a fater stagee The file is "shifted" if 
necess ar ye Character set converston Is also performed as 
required. 


BANNER place “large print™ banners of your bin number on the front 
of aprintout. BANNER is used at sites where output is 
placed in "bins", identified by a bin number. 


FICHE set up list file for microfiche processing. 
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301 PRINT = PRINT FILE(S) 


PRINT is a powerful facility for printing one or more fite{s). 
It tooks after the mundane matters of character’ set conversions, 
special disposition (route) codes ands ovoerhaps nost importantly, 
automatically determining whether each file to be printed has 
already been or needs to be “"formatted™ for’ a printer. 


f or i232 
specifies the name of the Files or a ftist of files to be 
printed. If the file(s) are not already tocal when PRINT 
is calleds PRINT tries to GET or ATTACH the file(s) for 
youe 


copies or c or fn 3 
(optional) specifies the Number of Copies of the printout 
you require. If you don?t code the c parameters PRINT 
produces 1 (one) copy. 


h or id 3 
loptional) specifies the Heading banner to be printed at 
the start of your printout. If you don*t code the h 
parameters the first two pages of the printout will have a 
"large print™ banner of the file ames date and time. 


hn or idn 3: 
(optional) specifies the Number of Heading banners to be 
placed at the start of the printout. If you don*t code 
the hn parameters PRINT produces 2? (two) heading banners. 


shn or sidn 3 
(optional) this parameter is used when printing more than 
one file at a time. When a tlist of files is printed» 
PRINT outputs a heading banner for the whole printouts and 
places a sub heading before each new file is started. The 
shn parameter specifies the Nunber of SubHeading banners 
to be printed before each new file. If you don't code the 
shn parameters, PRINT produces ? (two) subheading banners. 


printer or pr 3 
this {optional) parameter specifies on which printer the 
printout is to appear. If you dontt code this parameter 
or if you specify gscil» the printout is routed to the 
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full ASCII printer. If you specify gscli64» the printout 
is routed to 64 character ASTII subset printer. If you 
specify cdc» the printout is routed to a "normai™ CDC 
printer. Any other value for this parameter is illegal. 


bin. 2 

If you are at ae site allowing bin referencess printout 
needs some sort of a banner containina a Bin Numbers to 
tell operations which bin to place the output in. 
Printouts without a bin number frequentiy end up in ai bin 
labelfted NOS/WO BIN NUMBER. At the tine of writings all 
bins have identifiers of the forn digit digit Letters which 
means you must code the bin oarameter in the form of a 
strings for examples bin=e=*22at. The string detimiters are 
required if you dontt want SES comolaining about invaiid 
numbers. If you don'tt code a bin: narametears, PRINT uses the 
value of profile variable userbins and If there's no such 
profile variable defineds generates a fisting banner of 
NO-ID» which almost certainty guarantees that your output 
goes to the NOS/WO BIN NUMBER bin. 


setid : 
setid is another site dependent special for sites allowing 
bin references. If your orintout is destined for the 
*normal” {(printer=cdc) disolay code printers» not the ASCII 
printers and if your printout is farge (more than about 100 
pages). 


compres : 
(optional) keyword specifies multio!e copies are printed 
together on one ftisting with only one NOS bannere When 
compres is used the number of heading hanners is defaulted 
to zero untess overridden by specification of values for hn 
or shne 


cs612 or cs64 or cs812 : 

these (Coptional) keys can be used to specify the character 
set of the file{s) to be printed. If vou don*t code any 
of these keys or if you code the cs612 keys the filets) is 
(are) assumed to be in the NOS 6/12 ASCII character set. 
If you code the cs64 keys the file{s) is Care) assumed to 
be in the 64 character ASCII subset or display code 
character set. If you code the es812 keys the file{s) is 
(are) assumed to be in the "8 out of 12" ASCII character 
sete 
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shift or noshift or cmps : 


date or 


time or 


un 3 


fe 3 


these (optional) keys control whether the printout is 
SHIFTed before disposal to the printer. If you don't code 
any of these keys» PRINT examines each file to determine 
how to prepare it for printing (i.e. which of these keys 
should have been selected). Note : that this automatic 
determination works for the vast najority of files and 
that this parameter is provided for use onty in those rare 
cases where the automatic method faiis. Note atsos, that 
the option you select with this parameter applies to all 
files to be printed, and therefore in the automatic case a 
mix of "shifted" and “unshifted” files can be printed with 
one procedure call. If you code the shift keys PRINT 
shifts (ieee. adds "carriage controt™ characters at the 
left of each tine) each file in order to "format" the 
file(s) for printing. If you code the noshift key» PRINT 
assumes each File is already “formatted” for printing and 
therefore does no shifting. The emps key is a special 
form of noshifts where any line that contains only ailiin 
column one is deleteds and any tine starting with an 
asterisk (¥*) in column one itis atso deleted. This is 
Intended for printing the output of oregrams such as 
COMPASS and CATALOG which try to orint on “prime pages". 
This idea is out of date these dayss and the cmps key 
helps save paper. 


etad ; 

this (optional) key specifies the form In which the DATE 
is to be output on the banner. If you code the date key» 
PRINT uses the form 01 AUGs 785 «which is the default. If 
you code the etad keys you get the standard system date 
Format. 

ampm ? 


this (optional) key specifies the forn in which you get 
the TIME on the banner. If you code the ampm keys PRINT 
uses the form 4323 PMs which Is the default. If you code 
the time keys you get the standard systen time format. 


{optional) allows you to specify the user number for a 
printer not at the central site. 


(optional) allows you to specify a forms code. 
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Examples of PRINT Usage 


seseprint (myfiles hisfiles her file) 
REVERT. END PRINT MYFILE. -HERFILE- 


This exampte prints three files 3: myfille,s, hisfilte and herfile on 
the ASCII printer. The example shows the message that appears at 
the end of the print process. 


seseprint formouts cz3,s noshift 
REVERT. END PRINT FORMOUT 


This example prints three copies of the file formout without 
shifting the file (the noshift key). 
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PROFILE Variables for PRINT 


If you wish» you may establish default options for PRINT by 
setting variabies in your PROFILE. The profile variables that print 
uses are defined here. 


copies default number of copies to orint. 


hn default number of heading banners to print at the 
start of a printouts 


shn default number of subheading hanner’s to print at the 
start of every file in a multi file printout. 


printer default printer to be used. Refer to the printer 
parameter in the procedure deasertotion above. 


incset default character set of file(s) to be printed. Refer 
to the ges6l12 parameter described above. 


shift sets your default for shifting files or not. Refer to 
the shift key description above. 


userbin used only at sites allowing bin references. userbin 
sets up your default bin number. 


printer_un defautt user number of a remote priinter to be used. 
Refer to the yn parameter descriotion above. 


printer fc default forms code to be used. Refer to the fc 
parameter description above.. 


In addition to the profile variables described ahoves there are 
profile variables that PRINTID uses. Se2 the description of these 
at the end of the PRINTID procedure descristion. 


Note : because the userbin profile variables is used by PRINTs it 
is also used indirectiy by any SES oprocedure that uses PRINT. 
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userbin is also used by those SES procedures that can run in batch. 
If you run procedures in batchs userbin is used to place bin number 
banners on the batch job output. 
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3.2 PRINIIO = PRINI_"LARGE_PRINI"_HEADING BANNERS 


PRINTID is mainly used as a building block for other procedures. 
It produces a “ltarge print” heading banners that occupies a full 
pages using a program calied JOBID which ts described in an appendix 
to this document. Parameters to PRINTID are : 


h or id 3 
this parameter may be any arbitrary character string which 
specifies the text to be output. The string used can be 
anything that*s tegal for the JO819 orogram. 


copies or cor nor hn or idn : 
(optional) Number of COPIES of the banner that you want 
output. If you don*t code the copies parameters PRINTIDO 
produces two (2) copies. 


o or output : 
(optional) name of file to «hich the banner is to be 
Dutput. If you don't code the o parameters PRINTID uses 
file DUTPUT. 


date or etad : 
this (optional) key specifies the Form In which the DATE 
is to be output on the banner. If you: code the date keys 
PRINTID uses the form 01 AUGs 785 which is the defauit. 
If you code the etad keys you get the standard system date 
format. 


time or ampm ; 
this (optional) key specifies the form in which you get 
the TIME on the banner. If you code the ampm keys PRINTID 
uses the form 4323 PMs which is the default. If you code 
the time key» you get the standard systen time format. 


cs612 or cs6& or cs8l2 ; 
these (optional) keys specify the character set in which 
PRINTID output is to appeare IF you don't code any of 
these keys or if you code the cs64 key» output is in the 
64 character ASCII subset (can also be thought of as 
display code) character set. If you code the ecs612_ keys 
output is in the NOS 6/12 ASCII character set (since 
PRINTID output does not include any of the so-called 
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extended characterss cs612 is effectively equivalent to 
cs64 for this procedure), Tf you code the cs812 keys 
output is in the “8 out of 12" ASCII character sete 
Note : that when PRINTID fs catted by the PRINT 
procedures that this parameter ts set according to the 
destination printer; the PRINT procedure has a parameter 
with these keys and it refers to the character set of the 
file(s) to be printed. 


Note that the date and time parameters oniy have effect when the 
fh parameter is specified as a name. If you give the fh parameter as 
something other than a names it is up to you to include the date and 
time in the heading if you want it. 


Exampie of PRINTID Usage 
seseprintid idz*final/debug/document'»s o=banner’ 
REVERT. END PRINTID BANNER 


This example shows a title banner being formatted onto ae file 
calied banner. 
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PROFILE Vaciables for PRINTID 


You can establish defaults for various ®RINTID parameters by 
coding them in your PROFILE. The profile variables are described 
here. Also refer to the PRINT profile variables. 


myid is a character string specifying the defauit format § for 
heading bannerse For complete understanding of the 
following description refer to tha documentation for the 
JOBID program (which produces the banner’s) and to the SES 
Procedure Writer's Guide. 
The default heading banner format would be defined via this 
profile variable as follows 3: 


VL myid 89 t7tteevVAlLS tho tttt s/t tttenydatette! 4/7)! t+temytimet 


Other heading banner formats can be constructed in an 
analogous manner. To eliminate heading banners altogether 
(as the default case) you should code the following tine in 
your profile :. 


\ myid = NO 


Note that tn order to produce a heading hanners the tength 
of the string assigned to the myid variable must be at 
least 4 (four). 


mydate js a character string containing your version of the date. 
Refer to the date key in the procedure description above, 


mytime is a character string containing your ver'ston of the time. 
Refer to the time key in the procedure description above. 


outcset can be used to specify the default character set for 
PRINTID output. Refer to the @¢§64 key in the procedure 
description abovee Note that this variabte has no effect 
when PRINTID is being catied hy the PRINT orocedure. 
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AF - COPY SHIFTED ASCII FILE TO PREPARE FOR PRINTER 


303 COPYSAE_~_ COPY SHIFTED ASCII FILE TO PREPARE _FOR_ PRINTER 


COPYSAF 
The file 
requireds 
Parameters 


jor f : 
n 


( 
I 
t 


incset o 


outcset 


shift or 


prepares a file for printing on the NOS ASCII printer. 
in question is converted to the ASCII8 character set if 
and shifted (carriage contro! added) if required. 
to COPYSAF are 3: 


ame of Input Eile to be prepared for the printer, 


optional) name of file to receive the Qutput from COPYSAF,. 
f you don't code the o parameters the output appears on 
he file specified by the i paraneter. 


r ie : 
(optional) designator for the INput file*s Character SET. 
The table below describes the allowed designators. 


or oc 3: . 
(optional) designator for the OUTout file's Character SET. 
The table below describes the allowed desigqnators. 


noshift or cmps : 

these (optional) keys control whether the printout is 
SHIFTed before conversion. If you dontt code any of these 
keys» COPYSAF examines the file to determine how to 
prepare it for printing (that Is» which of these keys 
should have been selected). Note * that this automatic 
determination works for the vast majority of files and 
that this parameter is provided for use only in those rare 
cases where the automatic method fails. If you code the 
shift keys COPYSAF shifts (that is» adds “carriage 
control™ characters at the teft of each tine) the file in 
order to "format" the file for orinting.! If you code the 
noshift keys» COPYSAF assumes” the file is already 
"formatted" for printing and therefore does no shifting. 
The cmps key is a special form of noshifts where any line 
that contains gnly alin cotuan one is defleteds and any 
jine starting with an asterisk (*) in column one is also 
deleted. This is intended for oritnting the output of 
programs such as COMPASS and CATAL9G which try to print on 
"prime pages". This idea is out of date these days» and 
the cmps key helops save trees, 
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The iIncset parameter has a default of es612 (NOS 6-12 character 
set) and the outeset parameter defaults to es812 (ASCII character 
set suitable for the NOS ASCII printer)ds as: described in the table 
below, but these defaults can be overrtddan by defining in your 
profile defaults via variables with nranes the same as the 
parameters. The following table defines the allowed designators for 
the incset and outcset parameters 3; 


3 
3 
Desiagnatoc ; Meaning 


ne be we 


ary 
oe we ee 


; 

H 

; 

+ 

; 

; es612 $ NOS 6/12 ASCII character set 

; : 

ee ere ae cae ca se em ee se sae ae Se sm pe ce ee cae ee ee cee eee ce ee ee ee a en Oe OO EO + 
H ; H 
H es 64 $ 64 character ASCII subset (display code) ; 
: ; character set H 
; } ; 
ee a a a ee fe a ee ee eens ee ee + 
; ; ; 
H cs812 ; "8 out of 12" ASCII character set ; 
4 4a 2 
3 3 $ 
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Examples of COPYSAF Usage 


sesecopysaf tistings topresss noshift 
REVERT. END COPYSAF LISTING <-> TOPRESS 


sesecopysaf outfiles cs64 
REVERT. END COPYSAF OUTFILE 


The first exampte of COPYSAF converts the file Wisting from the 
6-12 character set to the 8-12 character set» placing the result on 
file topress. The noshift key ensures that the file is not shifted 
during the conversione The second example is converting a display 
code file to the 8-12 character set ready for printings and COPYSAF 
determines whether to add carriage control to the Fife. 
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34 BANNER = WRITE BIN NUMBER _ON_LARGE PRINT_ BANNER PAGE 


This procedure is a special form of the PRINTID orocedure for use 
by sites allowing bin references to identify printed output. 


BANNER is intended for writing the user's bin number on a Jarge 
print banner page lactuaity it produces two pages of banner) on 
printouts or in the dayfile of a batch job. BANNER produces two 
pages with your bin number arranged in a geometrical pattern that 
makes it easy for the process control persons to seee BANNER 
outputs the page in different patterns denending on the number of 
cheracters in your bin number. Parameters to the BANNER procedure 
are 3 


bin : 
; is your foptional) bin number. This must he specified in 
the form of a strings for example, binz'018d*. If you 
don*t code the bin parameters, BANNER uses the vatue of 
profile variable userbins and if therets no such profile 
variable defineds generates a bin number of NO-ID. 


o or output : 
is the (optional) name of the file on which the banner is 
to be written. If you dontt code the o parameters, the 
banner appears on file output by defautts making this a 
convenient defauit for batch jobs. 


Exampties of BANNER Usage 


sesebanner 
REVERT. END BANNER 


sesebanner bin=*l3b*, oztempout 
REVERT. END BANNER TEMPOUT 


The first example shows the simplest use of BANNER with the 
banner going to file outputs and the bin nunber either obtained from 
the userbin variable in the profiles or the defauft NO-ID generated. 
The second example shows how to code the bin number parameter on the 
procedure line. 
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PROFILE Variabies for BANNER 


The only PROFILE variable used by BANNER js 3 


userbin defines your output “bin” identifier as a character string. 


Neate : that the userbin profile variable is also used by PRINT» 
and thus indirectly by any SES procedure that uses PRINT. userbin. 
-is also used by those SES procedures that can run in batch. If you 
run procedures in batchs userbin is used t9 olace bin number banners 
on the batch job output. 
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305 ELCHE =_SET_UP_LIST_EILE FOR MICROFICHE. PROCESSING 


FICHE accepts an input file consisting of CY3TL» 180 Assemblers 
META Assembler or COMPASS code and writes it to a tape in a format 
suitable for microfiche processing at Comsource Headquarters. For 
any moduie name encountered in the fisting Filles a banner page will 
be generateds for visual aid on the microfiches and it will appear 
in the index of the microfiche. The tape which is made from running 
FICHE shouid be sent with ai Microfilm Work Request* (form no. 
AA5167) to Terry Larson = HOCOOH. The *Progran 1D0* used on the 
*Microfilm Work Request! is ARH1833. A ‘Master Tharge Noe? will 
atso be required to submit this "Microfitn Work Request'. Please 
contact Kathy Beatty (482-2338) for information needed to acquire a 
‘Master Charge Noe* Parameters to the FICHE orocedure are 3: 


fist or 1 : 
name of the fist file to be used as invout.! 


id 3: 
fiche id titie which will appear at the top of the 
microfiche. The id supplied should be a string ftimited to 
no more that 38 characters. 


tapeysn or vsn 3: 
number of the tape to be used for the output of FICHE. 


Example of FICHE Usage 


sesefiche tzulist ide*ses utilities? vsn=ses016 


This example shows the input file ulist being used to generate a 
fiche from the output contained on the tap2 vsn ses016- The tittle 
at the top of the fiche when it comes back from orocessing wil! be 
ses utilities. 
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4.0 DOCUMENT FORMATTING SYSTEM 


The documentation formatting system is a powerful set of programs 
that can produce documents from unformatted source texts containing 
directives to contro! margin alignments itamizings tables and so on. 
There are facilities to compare two versions of a document to 
generate revision bars to indicate changes» and facilities to change 
heading formats and so one 


The major components of the documentation system are two 
processors called TXTCODE and TXTFORM. ITXTSIDE is in fact a high 
fevel preprocessor for TXTFORM. Type SES.~TOOLNNS to reference the 
manuals that describe TXTCODE and TXTFORM,. 


After the main descriptions of FORMAT and FORMREVY, there are a 
number of “data fiow diagrams" showing the orocesses that are run by 
coding different parameter combinations on: a FORMAT or aie FORMREV 
procedure usage. 


FORMAT runs the complete document formatting system in all its 
manifestations and optionss while the rest of the 
procedures described after FORMAT are the individual 
components of the system. 


FORMREVY runs the document formatting systen to generate a revision 
packages compfiete with change vages and change directive 
Summar ye 


SPELL produces a tist of suspected misspelled words from aie text 
file. 


GRADLVL computes the reading difficulty of a docunent. 
TWOPAGE places two formatted document pages on one printer pagee 


DIAGRAM aids the construction of block diagrams such as those found 
later in this section, 
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MEMO 


TXTCODE 


TXTFORM 


TXTHEAD 


GENREVB 


GENREVP 


produces a standard format memo. 


runs the high tevel preprocessor for TXTFORM. 


produces a formatted document. 


a TXTFORM post orocessor which changes heading banners on 
document pages. 


works in conjunction with TXTFORM to format a document with 
revision bars down the right side of the page to show 
changes from a previous document. 


builds a revision package by conoaring the output of two 
formatted documents. 
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ok 401 EQRMAT_ = RUN. DOCUMENT FORMATTING SYSTEM 


FORMAT produces a formatted document elther Fron TXTCODE source 
{the default)» or from TXTFORM source.’ FORMAT normally runs in 
batch rather than interactivelys but you can run FORMAT atthe 
terminal if you -wishs by coding the focal key when you run it. It 
is usually better to run the document formatters In batch since they 
consume some time. Parameters to FORMAT are 3 


ior f 3 
name of Input File containing saurce data to be formatted 
by TXTFORM or TXTCODE. 


b or old : 
(optional) name of file containing a Base or OLD version 
of the document source. If you-code the b parameters 


FORMAT compares the files specified by b and i such that 
revision bars are printed on the formatted output 
document, 


jor tisting : 
(optional) name of file to receive the output of the 
formatter in a form suitabtfe for orinting on the ASCII 
printer. If you don't code the 1° parameter, and youtre 
running FORMAT LOCAL at your terninals the output appears 
ona file called listing. 


dor display : 
(optional) name of file to receive the outout of FORMAT in 
a form suitabte for DISPLAYing at’ a terminals, that is» the 
formatted document is truncated for a terminal screen. If 
you dontt code the d parameters FIRMAT doesn't produce any 
display file {untess you code the k parameter described 
below). 


batch job parameters ? 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH JORS". The default for this 
procedure is to run in batchn nodes but it can be run in 
focal mode. The dayfile parameter is used by this 
proceduree 
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print : 


(optional) controis the action of the PRINT procedures 
used to print the output of FORMAT. TF you run FORMAT as 
a batch job (the defauit case) and you don*t code the 
print parameter» FORMAT orints one (1) copy of the 
document on the ASCII printer. [ff yous run FORMAT in tocal 
mode or "white you wait", FORMAT does not orint any copies 
of the document. For a complete description of the values 
that may be coded for the print parameters see the 
description of procedure PRINT. 


S or source ; 


this (optional) key specifies that the SOURCE of the 
document is to be printed in addition to the formatted 
output. If you don't code the s keys the source isntt 
printed. 


k or keepout : 


code or 


head or 


(optional) name of file in which to KEEP the OGUTput of 
FORMAT. You can use this: facility where you may want to 
run many copies of a document at a later date. If theres 
no file of name specified by the « parameter in your 
catalogs FORMAT places the outout in a DIRECT access file 
of the specified name» If such a fite already exists» 
FORMAT overwrites it with the outout of the run. 


Note : that if you code the k par'ameters FORMAT produces a 
display file (see ahove) and saves thats rather than saving 
the full size listing file which Is usuattly large. 


form or txtcode or txtform : 

these (optional) keys determine which formatter is to be 
used by FORMAT to process the document source. If you 
don't code any of these keys» FORMAT runs the TXTCODE 
processs which is the same as if you coded the code or 
txtcode keys. If you code the forn or txtform keys FORMAT 
runs the TXTFORM processe Note: you can change the 
defauit selection by defining in your orofilte a variable 
called FORMAT and setting its value to *#TXTFORM® or 
"FORMS, . 


txthead 3: 

this {optional) key invokes TXTHEAD>» a special 
postprocessor for the document Fornatting system. TXTHEAD 
is used to change the headings that appear at the top of 
the document pages» where the standard headings are 
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twopage 


mSg or 


backup 


inaporopriate. Documentation for’ TXTHEAD can be found in 
an appendix to this User Handbook. If vou code the head 
keys FORMAT runs TXTHEAD. 


2 
» 


this (optional) parameters if codeds directs FORMAT to run 
the TWOPAGE procedure (described in this chapter) which 
places two pages on one printer Dagee Since the maximum 
width of a printer page is 135 colunnss tf you happen to 
have wide platen documents» the output tends to look rather 
stranges so for effective use of twopages your documents 
should be fess than 68 columns wide. twopage may be coded 
just asa keys or it may have a list of valuess namely the 
pw parameter and the seq keys as in the description of the 
TWOPAGE procedure later in this chapter. 


Note : that the twopage option only affects the printed 
copy of the output. The actuat data in the files specified 
by the d or t parameters is not affected. 


nomsg : 
these (optional) Keys control the generation of 
informative messages by this orocetdure and are fFfully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". : 


this foptional) key specifies that the source is to be 
processed by the old orocessor (TEXTCODE/STEXTFORM). If 
you don't code the backup key» FIRMAT uses the new 
processor (TEXTPRO). 
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Examptes of FORMAT Usage 


seseformat myfile 
17242255. SUBMIT COMPLETE. JOBNAME [5S ADCQBUSG 
REVERT. JO8 FORMAT SUBMITTED ; 


This is the very simplest example of using FORMAT. myfiie 
contains document source written in TXTCIDE form.’ The document is 
processed by FORMATs and one (1) copy ts printed on the ASCII 
printer. FORMAT runs as a batch jobs freeing up your terminal for 
further processing.s 


seseformat newfiles oldfites print=(c=2sh=no)s ss jobti=4000(8) 
13232255. SUBMIT COMPLETE. JOBNAME IS ADUQRBOS 
REVERT. JOB FORMAT SUBMITTED 


This example is more complex. The fites: newfite and ofdfifle 
contain respectively the latest and previous versions of a document. 
Both versions are coded in TXTCODE form. FIRMAT processes both tots 
of sources uses the revision bar generator to generate change bars 
on the final document. The source of newfile is printed because the 
s key is coded on the call tines [t's assumed that the documents 
are large and require iots of computer tine to orocess thems so 
jJobt!i=4000(8) is coded to give FORMAT twice the normal time. 
Finallys the print parameter specifies that two €2) copies are to be 
printed with no heading banners. 


seseformat iznewfiles bzoldfiles txtfora,s print=c2#4 
11.35243. SUBMIT COMPLETE. JOBNAME TS ADRICAD 
REVERT. JOB FORMAT SUBMITTED 


This example shows FORMAT used to format the document newfile, 
with oldfiltte as the base version for generating revision bars. The 
txtform key indicates that the source of the two documents is in 
TXTFORM formats and so the TXTCODE stage of FORMAT is bypassed. 
Finallys four (4) copies of the output are orinteds because of the 
print=c24 parameter. This ltast parameter indicates how the print 
parameter is coded when it has only one suboarameter in its tists as 
opposed to the exampie aboves where the print parameter has two 
subparameters in its tists, so that they nust be enclosed in 
parentheses. 
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seseformat izgrabage local print dz#looksee 

RUNNING TXTCODE ON GRABAGE 

RUNNING TXTFORM 

FORMATTED OGCUMENT ON FILE LISTING 

PRINTING LISTING 

CREATING DISPLAYABLE DOCUMENT LOODXSEE 

REVERT. END FORMAT GRABAGE ~> LISTING LOOKSEE 


eee HH 


This example shows how to use FORMAT at the terninals or “while 
you wait". The file grabage is assumed to contain the source of a 
document in TXTCODE form. FORMAT runs while you wait because the 
focal key is coded. FORMAT places the formatted document on a file 
called tisting and prints one (1) copy of 1 ' ye ASCII printer 
cause the print key was sp ed). The file calied tooksee 
contains a copy o ocument suitabte for displaying at 
a terminal. The eiaupie stows the informative nessages output by 
FORMAT to reassure you that there's something gotng on. 


seseformat draft batch twopage=seq 
12.10-30. SUBMIT COMPLETE. JOBNAME IS AMTBSOB 
REVERT. JOB FORMAT SUBMITTED 


This example shows the twopage option used to double up on the 
printed output. 
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4s 1 FORMAT = ick DOCUMENT PUSH) TENS ote" 


Data Flow of FORMAT Procedures 


seseformat izanyfite 
8 
% 


ee oes 
/ H 4i TXTCODE is a 
terme meme t | <= PREprocessor 
s:$ TXTCODE 3: 3 for TXTFORM 
; DOCUMENT $ + 
3 FORMATTER $7 
a oo. 


a 
/ 2 H 
$—----------+ | 
+ TXTFORM $ 3 
+s DOCUMENT $ + 
3 FORMATTER 37 
+ 


Coding the 
causes: the 
the input 
processed 
TXTFORM, 


C0 OG 28 1H we 18 48 2H OH we OG 


ee eae 
a - 3 
oe ae 
+: TXTFORS ¢ 3} 
+ BOCUMENT ¢ + 
3; FORMATTER $7 
ooo ooo: 


3 
a 


/ : H , ; aa 
t-[----------> To a 
: PRINT ; + PRINTER St PRINT : + 
: 7 aa 


The diagram shows two of the ways that FORMAT can runs 
on the options you code. The feft hand diagram shows the normal and 


simplest case of FORMAT. The right hand diagran shows 


the txtform or form key eliminates the TXTCODE process. 


sesefornat izanyfites txtform 


_ txtform key 
contents of 
file to 
directly by 


be 


depending 


that coding 


CDC —- SOFTWARE ENGINEERING SERVICES 
. 18 December 84 
SES Userts Handbook REV: 4A 


4.0 DOCUMENT FORMATTING SYSTEM 
41 FORMAT - RUN DOCUMENT FORMATTING SYSTEM 


seseformat iznewfiles bzoldfite 


this processes "newfile® this: does: "ol dfile”" 
8 9 
a $ 

a H 3. tv :. 73 


co ee ee oe ee ee ee ee cee 


TXTCODE 3 


H :. YXTCODE ¢ 3 
: DOCUMENT ¢ + : DOCUMENT ¢ + 
2 FORMATTER $7. +. FORMATTER t7 
ee oo a oes 
H $e meena t H 
H 4 43 H 
: toewweemeernnt | :. 
Poem wewmonmmwmnm—>i 6 6GENERATE {<tc ere nnn nnn mt 
: REVISION ¢ + 
H BARS i7 


3 
8 


fom nfeewone—+ 
, : : 
tern ewww nwt Ff 
: TXTFORM 3 
: DOCUMENT : + 
: FORMATTER tf 
ooo oe 


/ H H 


H § of enn wn —— =>: TH PRINTER 
3 PRINT : + 

; HEA 

few eww wn o nny 


This diagram shows the action taken when you run FORMAT with a 
current document and a "base™ version of the document. The revision 
bar generator compares the two files after’ TXTCODE has processed 
thems and generates the commands such that TXTFIRM knows where to 
place revision bars in the final document. 
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ses.format myfile source 


; 
; 2 
4 H 7% r : i 


9 
9 
+ TXTCODE $$ 3 H ; 3 
7. DOCUMENT ¢ + H PRINT ; + 
: FORMATTER i? H WT 
oe os oe | 
H H 
$ ween foe wr we wt : 
/ H 43 TO 
frown cmeen} | PRINTER 


$ TXTFORM ¢ $ 
: DOCUMENT $ + 
: FORMATTER i7 
oo ooo. 


j H 73 


a 
PRINT $ + 

a 

r ] 


3 
q 
8 
a 
8 
& 
+ 


This diagram shows what happens when you run FORMAT and code the 
source key.» The source of the document is’ printed directiys then 
the formatting process takes place to produce a formatted document. 
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4o2 FORMREV = FORMAT A_ REVISION PACKAGE ERIM DOCUMENT SOURCE 


FORMREV is intended to format documents and run the GENREVP 
package described tater» to produce a ravision package for a 
document. FORMREV uses the FORMAT and GENREVP procedures in a 
manner suitable for most of the standard day to day document 
applications. If you have any comoticated situatisans you should use 
FORMAT and GENREVP *"manually™ to cater for the situation you wants 
Parameters to FORMREV are 3 


i or f or new 3: 
name of NEW Input File containing the new document source 
to be processed by FORMREV. 


bor old : 
. (optional) name of file containing OLD document source to 
be processed by FORMREV. If vou dontt code this b 
parameter, you should supply the File specified by the r 
parameter. 


r or riist : 
(optional) name of file containing the output of a 
previous FORMAT rune If you dontt code the r parameter » 
you should supply the file specified by the b parameter. 
Of courses both b and fr may be soded. 


lor tisting : 
(optional) name of file to receive the tisting of the 
selected pages after the comparisor. If you don't code 
the ! parameters FORMREV uses file Listing. 


s or summary ; 
(optional) name of file to receive the summary of the 
changes» and a “how to update the document" description. 
If you dontt code the s parameters FORMREV uses File 
Summary. 


o or output ; 
(optional) name of file to receive the OUTPUT of FORMREV. 
The output file contains error’ nessages and statistics. 
If you don't code the o parameters FORMREV attempts to use 
PROFILE variable outputs and if such a variable doesntt 
exists file output is used. 
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batch job parameters ? 


print : 


These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH JO8S". The default for this 
procedure is to run in batechn mode, but it can be run in 
focal mode. The dayftite paraneter is used by this 
procedure. 


{optional) parameter tist (as For the PRINT procedure) 
which controls the PRINTing of the %> s: and o files. If 
you run this procedure in focal’ modes no printing is 
performed. If you run this as a batch jobs the default 
action is to print one (1) copy of those files. 


format or formatl : 


format2 


genrevp 


(optional) tist of parameters to control! the FORMAT run 
that produces the new version of the text. The parameters 
are as for the FORMAT procedure described previously. 


2 
2 


(optional) tist of parameters that control the FORMAT run 
that produces the ofd version of the texts in the case 
that the r parameter wasn't coded. The parameters are as 
for the FORMAT procedure described oreviousty. 


4 
2 


{optional) list of parameters that contro! the actions of 
the GENREVP procedure described belfows when GENREVP is 
callied into play during the run of FORMREV to produce the 
final output listings. The paraneters are as for GENREVP 
described below. 


msg or nomsg : 


these (optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Examples of FORMREV Usage 


seseformrev: iznendocs bz=olddoc 
09245234. SUBMIT COMPLETE. JOBNAME IS AEXICOG 
REVERT. JOB FORMREV SUBMITTED 


This exampie shows FORMREV used to generate a revision package by 
comparing nendoc {the current version) with ofddoc (the previous 
version). FORMREV produces a printout consisting of those pages 
which differ between the two documents» and a summary indicating 
which pages are changed. The changed pages have revision bars 
against those tines that differ. 


seseformrey newdocs rzoldlists format=txtforms jobti25000(8) 
14245256. SUBMIT COMPLETE. JOBNAME IS JACIBHI: 
REVERT. JOB FORMREY SUBMITTED 


This example generates a revision oackage by comparing the 
results of formatting the current document newdoc with the old 
listing file oldlist. The formatting process is to be done with the 
TXTFORM formatters bypassing the TXTCODE orocesss» as indicated by 
the formatztxtform parameter. The job time timit is set to 5000 
seconds (octal) by the jobtt=5000(8) paraneter, 


seseformrev izcurrents bedateds genrevoz{howzcomnfiles folio) 
16232248. SUBMIT COMPLETE. JOBNAME IS AFTXBUD 
REVERT. JOB FORMREVY SUBMITTED 


This exampie shows FORMREV used to generate a change package for 
the documents current and dated. The portions of the listing pages 
that are to be ignored are not the standard ones normatliy used by 
the GENREVP procedures so the genrevp paraneter is coded to indicate 
that the directives are on file comfiles and that the folio tine 
{indicated by the folio key) is atso to be ignored for the purpose 
of comparison. 
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4.0 DOCUMENT FORMATTING SYSTEM 
A REVISION PACKAGE FRIM DOCUMENT SOURCE 


4.2 FORMREV — FORMAT 


Data. flow of EQRMREV. Procedures 


seseformrev iznewnfiles bzoldfite 
: a 


/ : n 
prenwenennenny } 
: TXTCODE 3: 3 
: DOCUMENT ¢ + 
$ FORMATTER 3/ 
+ 


& a ee 06 ou a6 


The diagram shows how 
FORMREY processes a 


current version of a 
documents and an oid 
version of the same 


documents to generate 
a change package with 
revision bars on the 
changed pagese 


8 
t 


a 
i H 73 
eee ae 
$ TXTCODE :? 3 
3 DOCUMENT 3. + 
$ FORMATTER i7 
Se ee 


a es 
4 H H 
Forweomeewwoen} | 
+ GENERATE ¢ 3 
REVISION ? + 
H BARS He 
en coe s 


rr ooo 
/ : H 
{—==—---- == +2 
: TXTFORM : 3 
: DOCUMENT = + 
2 FORMATTER 37 


oe os 
| H 43 


oe | 
r :. 43 
nn a | 
t TTXTCODE ¢ 3 
3 DOCUMENT = +¢ 
$ FORMATTER $7 
+ 


28 28 64 a 26 2H aH wh 2G 
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seseformrev i=newfites bzotdfiles rzolditst 
 ] 3 2 


8 

+ REVISION ¢ + 
: BARS s/f 
+ 


$-------- anetaateeteateete 2 teen nwt H 

H 3 : 

$oe nw ot 2m enon t | aia Decteeteteten 2 H 

| i H : i 3 43 Ha 

Freecom ewan} 5 t+ =s<— aeomnt § : 
$; XTCGDE ¢ 3 ?. TXTCODE 3 3 + 
$ DOCUMENT 3 + $$ DOCUMENT ¢ + H 
2 FORMATTER 37 3 FORMATTER i7 3 
$e en nn — t= + $ew we we foment : 
H H H 

town ato + : : 

i 3 H H H 

toes oesoween} 3 3 . 
GENERATE $< 4-239 + : 

% 

: : 

: 

H 


4 He 43 t H 43 
eo ew an ae ean an aw a om > a powwwewonewmeg ! 


a é 
s: DOCUMENT ¢ + REVISION : + 
3 FORMATTER 37 PACKAGE i/ 
$e n n+ —t————+ 


~~ «6 «& 


ie ‘. fi 

ee a 

TO 7 2 3 
eee SO | a 
PRINTER $ a 


This diagram shows FORMREV used to generate a revision package 
where all three forms of the document are used : the current 
version of the documents newfiles the ofd version of the document 
sources oldfiles and the old document Jitstings oldtist. In this 
cases FORMREV uses the old tisting as the base against which to 
compare the processed version of the new document. Because the old 
document source was used as wells», the change pages produced by 
FORMREV have revision bars on them. 


4-16 
CoC - SQFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
4,0 DOCUMENT FORMATTING SYSTEM 
4.2 FORMREV —- FORMAT A REVISION PACKAGE F294 DOCUMENT SGURCE 


seseformrev iznewfiles rzoldlist 
H 
ee ae em ee en ee eee ae eee ee ae ee ee ee oan ae ae ea ae oe 
a 
9 


+ ) 
* TXTCODE ¢ 3 
$ DOCUMENT ¢: + 
: FORMATTER 3/ 

+ 


ee es 
/ He 43 
freemen} | 
3 FXTFORM : 3 
$s DOCUMENT ¢$ + 
3 FORMATTER 3/ 


> OG 2G 40 C8 66 4h 40 BO 4H BO 44 26 


| 
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| 


2 
& 
mf n 
: 3 


s 
temewnnnmnm———->i «GENERATE i i 
i REVISION | + 

$ PACKAGE ${/ 


H 
a —+ 
/ H H 


J=f----------> TD PRINTER 
H PRINT + + 
H : 


econ a ape ae enema ae cs 


This diagram shows the simplest use of FORMREV, The current 
version of the document is compared with the old listing of the 
document in order to generate a change package. [1 this case there 
are no revision bars generated on the final output since there was 
no old document source given to FORMREV to be processed. 
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43 SPELL = CHECK FILE _ FOR SPELLING MISTAMES 


SPELL checks for words in a document: that: are spelied 
incorrectly. Parameters to SPELL are : 


i or f 3: 
name of Input File to be checked For soetling mistakes. 


Oo 3 
(optional) name of the file to raceive the Output from 
SPELL. If you don't code the o parameters, SPELL uses file 
OUTPUT. 

dict or d 3 


Coptional) name of a file containing words (one per lines 
feft justifieds all letters in upver case) that are to be 
used in conjunction with standard "dictionary" used by 
SPELL. If you don*t code this parameters SPELL uses onty 

the standard dictionary (containing approximately 50000 
words) when checking for misspelled words. 


dictun or dun : 
(optional) Username in whose catalog the additional 
dictionary specified by dict is found. The default is the 
current user's catalog. 


fo : 
(optional) List options availabie for output format. 
briefs the defauits displays three columns containing each 
"nispelled™ words, the input file tine number at which the 
word was first encountereds and the number of subsequent 
references of that word in the text. 
full is a#$proof reader's fornat. The entire text line 
containing the “misspelled" word is orinted out and the 
word in question is "flagged" on every occurrence. 


batch job parameters ;: 
These parameters are described itn the section entitied 
"SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in focal nodes but fit can be run in 
batch mode. The dayfile parameter is not used by this 
procedureé.s 
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msg or nomsg 3 
These (optional) keys control the generation of 
informative messages by this procedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*, 


Examptes of SPELL Usage 


sesespeii newdoc 
REVERT. END SPELL NEWDOC 


This example shows the simplest use of SPELL. A tist of the 
words in file NEWDOC that are suspected to be misspelled along with 
a count of the number of times each occurs is written to file 
QUTPUT. Gniy the standard dictionary was used since the dict 
parameter was omitted. 


sesespell izsomedocs dictzjargons ozbaddies 
REVERT. END SPELL SOMEDOC 


This example shows SPELL applied to a file calted SOMEDDC with 
additional words from dictionary file JARGON. The output of SPELL 
appears on file BADDIES. 
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404 GRADLVL = DETERMINES READING LEVEL OF _A_DOQCJMENT 


GRADLVL reads the input file and computes the reading difficulty 
of the document. Difficulty is expressed in terms of the U.S. 
grade level that would find the document understandable. Two 
reading tevel measurments are computed» the Flesch and the Kincaid. 
In general» the Fiesch measure will report a slight!y higher grade 
level than the Kincaid. For technical materials the Kincaid value 
is probabty more accurate. The thical® option will orovide ai fist 
of document words of three or more syllables on the output file. If 
the reading tevel of your document is too highs try substituting 
simpler words. Parameters to GRADLVL are ? 


ior f : 
name of input file containing text to comoute the reading 
difficulty of. 


0 2 
(optional) name of file to receive the output of GRADLVL. 
If you don't code the o paraneters GRADLVL uses File 
OUTPUT. 

incset ; 
Coptional) designator for the INout file's Character SET. 
The table below describes the alfowed desiaqnators. 

outcset : 
{optional) designator for the OUTout File'"s Character SET. 
The table below describes the allowed designators. 

hical : 


(optional) key provides a list of document words of three 
or more syllables on the output file. 


Both the incset and outeset parameters defauit to ¢s612 (see below). 
The following table defines the allowed designators for the tneset 
and outcset parameters : 
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3 
Designator : Meaning 
E | 


cs612 +; NOS 6/12 ASCII character set: 


a 
a 


A ee ee a on ee an an se ae ne ce a te eS OS OH A A OS A a HS MD me Se ee aE RD 
cs64 64 character ASCII subset (display code) 
character set 


oe we 66 we oe we we ff oe oe Oe oe et ow 
+6 we we ip we 2s ae Be db 68 we oe bp we oe ne 
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405 THOPAGE =~ PRINT TWO DOCUMENT PAGES _SIDE_B3Y S108 


TWOPAGE takes the output of any of the text processors and places 
two output pages on one printer pagee This raduces both paper usage 
add print times which is invaluable while documents are in their 
development stages and being turned around fast, 


The input for TWOPAGE must be in 8 of 12 ASCII format and pot in 
NOS 6/12 ASCII. [ts output is also in 8 of 12 ASCII. Parameters to 
TWOPAGE are ; 


ior f 3 
name of Input Eile to be processed by TWOPAGE. 


optional) name of Qutput file fron TWOPAGE. If you dontt 
code the o parameters, the output appears on a file of the 
Same name as the input file specified by the i parameter. 


pw or width ; 
(optional) Page Width of the output pages.» If you dontt 
code the pw parameters TWOPAGE uses a default page width of 
137 (136 columns pilus one column of carriage control}. 
Remember to cater for the carriage control column when 
soecifying the page width. 


seq : 
this f{optional) key indicates that QEQuence numbers are to 
be ptaced on the final printout.’ The sequence numbers 
appear down the center of the printer page between the two 
document pagese Default action in the absence of the seq 
key is no sequence numbers». 
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Examples of TWOQPAGE Usage 


sesetwopage iztextouts oxzlistings seq 
REVERT. END TWOPAGE TEXTOUT => LISTING 


sesetwopage formatd 
REVERT. END TWOPAGE FORMATD 
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425 DIAGRAM _- DIAGRAM DRAWING AID 


DIAGRAM is a documentation aid for drawing diagrams. The “data 
fiow diagrams" in this section of the SES User's Handbook were drawn 
using DIAGRAM. S8asicallys a page is considered as a three columny 
five row grids into which you can place various shapes. You still 
have to do some manual editing to join lines and add texts, but the 


bulk of the pain of drawing the shapes Is done for yous Shapes 
available via DIAGRAM are those shown belows with their “names* 
given for reference. 
$; *BOX® :. "COND" 
: 7’ 
a 2 ees town enf (wenn m+ 
3 KXXXKKKKKKKKK § $ MMMM KKK 3 
"BLANK*® 5 KK MKKKKKKKKKK § 5 MRM KKK § 
2 KM RKKKKKKKKKX 3 2 MMMM KKKKKKKK § 
tere ewen foe mwas} pewmnmnl§ 2 fmm —4 
H Vr 
H H 
: “CONN® "IN" : *"LINE* 
H H 
- 3 
/ \ \ I H 
ix \ 4 ; 
\ / \/ H 
- 3 2 
3 H H 
: : H 
: “OuT" : *STACK® $. *TABLE®* 
3 ee ee | a oe | 
Hy H H 2 TABLE . 
4 $— toon nnn nm—t+ jf | wer eee mee enon H 
| \ 3 t=+ S$ MXR KKK KKKKX F 
/ \ toe femmmmmnn—y § $ MMR KKK § 
2 MKKXKKKKK S—+ 2 MMM KKKMKKKKK §F 
Se +-—-—+ ee er | 


a 
4a 


% 
s 
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: "CUBE" 

ooo 

| H 4% 

teronmnamnenny ? 

2 XXXXNKKKXK § 3 

2 MRMKKXKKX § + 
5 XKMKKKKKX Ff 
Oe ooo 


To use DIAGRAM you call up the SES DIAS2AM procedure with the 
following parameters ;3 


name of the file to receive the Jutput from DIAGRAM. This 
parameter is required. 


The next three parameters are introduced by the keywords cl and 
c2 and ¢c3. They represent a list of shapes: that are to be placed in 
column ones column two and column three of the page grids 
respectively. For examples the grid of shapes given above was 
generated by the following SES calf : 


sesediagram ozanyfiles clz(blanksconnsoutscubeds. eseise 
c22(boxsinsstack)s c3=(condstinestable): 


where anyfile is the output file used for the exanple,. The shape 
"names" were added by editing the outout file. It is usual to 
inctude diagrams in your file in "asis™ mode. 
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407 MEMO -_ GENERATE STANDARD MEMO HEADER 


MEMO places a standard TXTCODE format banner at the front of a 
file containing the text of a memo. Dates ‘to's "from? and subject 
information can be entered as parameters to MEMO. Internal to the 
resuitant files the TXTCODE table directives are set up such that 
further recipients’ names may be added easily. Parameters to MEMD 
are as follows : 


ior f ; 
name of Input Eile containing the text of your memos to 
which the standard header is to b2 added. 


o 3 
(optional) name of the file to receive the Qutput of MEMO. 
If you. don*t code the o parameters MEMD ofaces the output 
on the file specified by the i parameter. 

to 3 
Coptionai) name and location of the person to whom the memo 
is to goe It is coded as a fist3 the first item in the 
fist is the recipient*s name and the second item is the 
location. 

from 3. 
(optional) name and tocation of the person sending the 
memoe It is coded similar to the to voaramneter. 

when 2 : 
{optionai) date to be piaced on the memo. If you dontt 
code the when parameters MEM uses today's date as a 
default. 


s or subject : 
(optional) string which is the subject tine to be placed in 
the memo. 


Some of the parameters above can get deafaultt information from 
your profiles as follows ; 


faccode is the EACility CODE variable. The value of faeccode are 
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myname 


used both for the to and from tlocation if they arentt 
specified as parameters. 


is the profile variable containing your names which is also 
used by the mail facilities. If you: don’t code the first 
element of the from parameter tists MEMD uses the myname 
profile variable. 


By this time you should be suitably confused by this exptanation 
$o an exampte is in order 3: 


sesememo izanyfiles toz(*Ethel Snerge's londondss.ecec'e's 
frome('Stanisilaus Bonokowonokowitch's parisdsecsses 
sub ject=*hunting the snark! 


REVERT. 


The 


END MEMO ANYFILE 


result af this would be a standard neno header at the start 


of anyfile as shown on the next page °; 


4-27 
CDC — SGFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: GA 
4.20 DOCUMENT FORMATTING SYSTEM 
4.7 MEMO ~- GENERATE STANDARD MEMO HEADER 


\para 

\setu” 

\seth* 

\setba 

\bi ank010 

\skip4 

Nasis 

\bold 

EEEEEEE 


“aon 
aon 


M M M M 
4 MoE M M 9 0 
M M OM EEEEE MM MOO 0 
M M CE M M 9 Q 
M M EEEEEEE M M 
\noboid 
\tables1s45 
A\skip4 
3***DATE*3“°MAR 1459 1979 
\skipl 
\table3;1545 
3*****TO*:*ETHEL SNERGE3 LOCATION’: “LONDON 
\table311s56 
\skipl 
\table31545 
3“““FROM“*: “STANISLAUS BONOKOWONOKOWITCHSLOCATION”: “PARIS 
\tabie3;11.,56 
\skip2 
Nt abie31s45 
3SUBJECT*:*"“HUNTING THE SNARK” 
\biock 
\skip4 
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4o8 IXTCODE =-_RUN_TXTCODE DOCUMENT. PREPROCESSO3 


TXTCODE is a high level preprocessor for TXTFORM. This procedure 
runs TXTCODE in a stand alone fashion. It nay be used as a building 
biock for larger procedures to form a comolete document formatting 
system. Parameters to TXTCODE are : 


name of Input File containing source text to be processed 
by TXTCODE. 


0: 
(optional) name of file to receive the Qutput from 
TXTCODE. If you don't code the o parameters, the output 
appears on the file specified by the 1: parameter. 

e 3: 


(optional) name of file to receive the Error output from 
TXTCODE. If you don't code the e parameters TXTCODE 
doesn*t produce any error file. 


Example of TXTCODE Jsage 


sesetxtcode codein codeout errtlist 
REVERT. END TXTCODE CODEIN > CODEDUT,. ERRLIST 


This example shows TXTCODE used to process: the data contained in 
File codeins and produce the TXTFORM source on file codeoute Any 
errors go to file errlist. 
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409 IXTEORM -_RUN_TXTFORM DOCUMENT. PROCESS23 


TXTFORM is the main component of the document processing system. 
This procedure runs TXTFORM stand alone. It can be used as a 
building block for larger procedures to form a complete document 
formatting system. Parameters to TXTFORM are = . 


name of Input File containing source text to be processed 
by TXTFORM. 


{optional) name of file to receive the Qutput§ from 
TXTFORM. If you don't code the o parameters the output 
appears on the file specified by the i parameter. 


Exampie of TXTFGRM Jsage 


sesetxtform izforminps ozformout 
REVERT. END TXTFORM FORMINP => FORMOUT 
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4010 IXTHEAD =_ PAGE HEADING. PROCES3 08 


TXTHEAD is a postprocessor for TXTFORY, TXTHEAD is used to 
change the format of the heading banners on document pages» where 
the standard heading Format is inaporooriate. There is 
documentation on TXTHEAD In and appendix to this User Handbook. 


This TXTHEAD procedure runs TXTHEAD in a stand alone fashion. It 
may be used as a building block for targer orocedures or jobs to 
form a complete document formatting syste. Parameters to TXTHEAD 
are 3: 


ior fF 3: 
name of Input File containing TXTFORM outout which is to 
be processed by TXTHEAD. 


o 
ee 


{optional) name of file to receive the Qutput From 
TXTHEAD. If you don't code the o oarameaters the output 
appears on the file specified by the i parameter. 


Example of TXTHEAD UYsage 


sesetxthead iz=formouts ozheadout 
REVERT. END TXTHEAD FORMOUT => HEADOUT 


This exampie shows TXTHEAD being used to process the output of 
TXTFORM contained on the file formouts and oroduce the output file 
headout. 
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4e11 GENREVS_=_ GENERATE REVISION BARS FOR _QQCUMENTS 


GENREVB is a procedure that works in conjunction with TXTFORMs 
format a document with bars down the right hand side of the page 
Show changes from a previous document. GBENREVYB functions 
comparing the source text of two documents: and generating a set 
special directives to TXTFORM. Parameters to GENREV® are 3: 


ior f or new : 
name of File containing the NEW version of the document 
TXTFORM source format. 


b or old : 


to 
to 
by 
of 


in 


name of file containing the OL. (or Base) version of the 


document in TXTFORM source format. 


o ? 
{optional) name of file to receive the Qutput from 
GENREVB. If you don't code the o parameters the output 
appears on the file specified by the i parameter. 

newcset : 

(optional) designator for the NEW filets: Character SET. 
The table betow describes the allowed designators. 

oldcset : 

(optional) designator for the JLD file's Character SET. 
The tabie below describes the allowed designators. 
outcset : 


{optional) designator for the OJTput File's Character SET. 


The table below describes the allowed desiqnators. 


ls or ignoris ; 


these (optional) keys specify whether or not to JGNQRe 
Leading Spaces on tines being comoared. The default action 
is to recognize teading spaces (the Is option). If you 


code the ignorts keys GENREVB ignores leading spaces 
text lines. 


on 
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The default character set designator for all. three cset 
parameters is gs6l]2- The following tabte defines the allowed 
designators for the cset parameters ? 


fp ew ce ee eer ee ne eee ae ew ee een ee ee ee sae dp SE AU EN AD A SND AE ES OND I ED AED EET AD AD Ea ES AN AN OE ODS SAN ND OD AD ED OD OD ED ED ND ND ND A ED he ee ee > 


Designator Meaning 


ee ae oe 


cs612 NOS 6/12 ASCII character set 


oe 26 2 


cs64 64 character ASCII subset (display code) 
c 


haracter set 


ee. ae ae TY 


Ae Se Nee aD ae ee na a ae ane came nate tome a Resa aD aD nek ante ane URED EOD Kei clas OU ES OE EE I ES ED RED GI SR RE ED ED RR AED ED i OED OBES “SS ED RN WR <dED KURS RTD SUED ON AI AN ED SE HD 


cs 812 "8 out of 12" ASCII character set 


on +e we 
oe we Oe ap ee oe ee ow hh) oe ae me dh ee oe we 


oe 68 we oe Oe ee ae Be oe hb Ge oe oe 


Exampte of GENREVB VJsage 


sesegenrevb iznewtext,s bzoldtexts o=changes 
REVERT. END GENREVB WNEWTEXT 3: OLDTEXT => CHANGES 


This example shows GENREVB used to compare the two document 
source files newtext and oldtexts and produce the change directives 
in the text on file changes 
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4.12 GENREVP_=-_ GENERATE _A_REVISION PACKAGE CIR _A_DICUMENT 


GENREVP builds a revision package by connaring the output of two 
formatted documents. Parameters to GENREV®? are 3 


new or newdoc 3 . 
name of NEW DOCument to be processed by SENREVP. 


old or olddoc ? 
name of OLD DOCument to be processed hy GENREVP. 


how or howfile : 

is Coptional) and specifies HOW the processing is to be 
performeds that is» which lines are to be Ignored for the 
purposes of the comparison (dates tine and such). The how 
parameter is either the name of a file containing the 
directivess or it*s a tist of character strings on the 
control card which specify the directives. If you donft 
code the how parameters GENREV? attempts to use the file 
name associated with PROFILE variable myhowf. If there 
isn't such a variable in your orasfiles GENREVP uses a 
standard set of directives suitable for the standard 
output of FORMAT. 


ior tisting : 
(optional) name of file to receive the fisting of the 
selected pages after the comparisone If you don't code 
the 1 parameters GENREVP uses file tisting. 


S or summary ;: 
{optional) name of file to receive the summary of the 
changes» and a “how to update the document™ description. 
If you don't code the $ paraneters GENREVP uses file 
summary. 


o or output : 
(optional) name of file to receive the OUTPUT of GENREVP. 
The output file contains error nessages and statistics. 
If you don't code the o parameters GENREVYP attempts to use 
PROFILE variable outputs and if such a variable doesntt 
exists file output is used. 


folio ; 
this f{optional) key indicates that the FOLIO tine of the 
documents is not to be compared for the purposes of 
generating the revision package. 
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GENREVP Directives 


Directives to GENREVP {specified via the how parameter) are of. 
the following form Cone per line) : 


Lleei2 C1.2.C2 comments 


Lieel2 specifies a range of lines (if you onty want to indicate a 
Single fines the e.el2 can be omitted; and if you: want to indicate 
all diness use an *)3 and C1l..C2 specifies a range of columns (if 
you only want to indicate a singie columns the .2C2 can be omitted; 
and if you want to indicate all columnss use an *). Any comments 
present on a directive line are ignored. The directives are used to 
teil GENREVP what parts of what tines’ ar2a to be ignored when 
comparing pages of formatted documents for differences. The 
standard set of directives is : 


2 600279 page number 

3024 60.279 date 

* 80.2136 formatting codes (junk) 
60 * folio tine 


The itast directive is generated onty if the folio parameter Is 
given. 


Examples of GENREVP Usage 


sesegenrevp thisdocs thatdocs folio 
REVERT. END GENREVP THISDOCsTHATDIC -=-> LISTINGs SUMMARY 


This example of GENREVP compares the two document tistings 
thisdoc and thatdoc to generate a listing of the changed pages on 
the file tistings and a summary of the changes on the file summary. 
The folio key indicates that the fotio fine is also to be ignored. 
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sesegenrevp grabs holds how=(93.24 602.279%s ** 80..999!') folio 
REVERT. END GENREVP GRABsHOLD <--> LISTINGs SUMMARY 


This example shows the how parameter of SENREVP used to indicate 
that character positions 60 through 79 on lines 3 through 4 are to 
be ignored for the purposes of comparison» and that character 
positions 80 through 999 on all (*) fines are to be ignored. In 
additions the folio key indicates that the folio fine is aiso to be 
ignored. 
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300 SOURCE _ TEXT MAINTENANCE 


SES provides a comprehensive set of procedures to manage source 
text Jibraries. The source text maintenance package of SES is based 
on a special version of the NGOS utility MODIFY called MADIFY. 
MADIFY differs from the standard version in that it caters to the 
NOS 6/12 character set; and it supports nested and gonditiongl calls 
to common decks {see the description of the GENCOMP procedure for 
details on the CALL directives availtabie to the MADIFY user). 


It's assumed that if you're using these source text maintenance 
proceduress that you're moderatety faniiliar with the concepts of 
MODIFY» including things such as decks» conmon deckss correction 
idents and so one Before giving a short sunmary of the source text 
maintenance procedures, wettl introduce some of the terminology that 
SES uses. 


BASE is a library of source texte: Ai? the source text 
maintenance procedures use a default name of BASE. You can 
establish a default base in your orofile by coding 


\ base = *whatever_your _base_is® 


MODULE is a single record of source text on a base@e. A module may 
be a COMMON module (COM or C or °LC)» or a module may be a 
REGULAR modute (REG or R or OPL) 


GROUP is a file containing text in the form of MODIFY "source" 
records. [hat isz each logical cecord in the file has its 
name as the first line of the recorde and If the cecord is 
ert decks the second tine of the record is the worg 


Ooze 
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aummary Of Source Text Maintenance. Procedures. 


GETMOD(S) 


REPMOD(S) 


COLLECT 


GENCOMP 


GENCOR(S) 


TEMPCOR 


MODIFY 


CATBASE 


LISTMOD 


SORTMOD 


WIPEMOD 


GET MGDuteS out of a base tibrary anto a group file. The 
modules appear on the group file in MODIFY "source" 
format as one module per Jogical record, 


REPlace or add MODuleS on a base ftibrary. You also use 
REPMOD(S) in a special way to create a brand new base 
library from scratch. 


collect a group of modules and accunutate them on a group 
file. 


GENerate a COMPile fiite for a2 nodule or a list of 
modules. 


GENerate a CORrection Set for a nodule. 


Make TEMPorary CORrections to a base without actually 
creating a new base. 


MODIFY a base ftibrary with a correction set File creating 
anew base jibrary. 


CATatogs a BASE library to produce a short tist of the 


names and types of modules contained in a base Utibrary. 


LIST MODules. LISTMOD generates a cross reference 
listing of all the modules on a base (using the XREFMOD 
procedure described betow)s and optionally a source 
listing of all the modules or al! the common modutes9 on 
the base@e 


SORT a MODify tibrary. Modules anpoear on the sorted base 
in alphabetical order by deck nane (the deck type is not 
used in the sort process). 


WIPE (delete) MODuies from a base. 


aS 
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XREFMOD 


GETCOMN 


SYSTEMX 


Scoop 


Produces a cross (X) REFerence of MODules in a source 
library. For each moduie is listed the modules it calis 
(directly or indirectly) and the mnodujes that call it 
(directly or indirectly). The LISTMOD procedures 
described aboves, can be used to run XREFMDD as aie batch 
job. r 


ACQUIRES the CYBCCMN or CYBICMN common deck program 
jibrarys in the MADIFY or SCU forms and nakes it iocal to 
your control point. 


a MADIFY based CYBIL system cross: reference facility. 


Compares MADIFY or UPDATE source files. 
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Data flow. of the source text maintenance orocedures 
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: (extract i 
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NEW BASE 
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520 SOURCE TEXT MAINTENANCE 


ee Cc! i eS a 


This section introduces the parameter ranting convention common to 
most of the procedures in the source text maintenance system. 


bor { name of Base Library on which the operations are to 
be performed. 


c or com or opic list of name{s) of COMmon nodule(s). 
r or reg or op} list of name(s) of REGular’ nodute(s). 


m stands for Module(s)»s and is used in those 
applications where the nodule nanes do not have to 
be explicitly specified as common or regular. 


g or group name of file upon which a GROUP of modules are 
accumulated when adding or replacing modules on a 
bases or when modules are extractad from a base. A 
group file contains one nodute oer togical records 
and may be edited using procedure MULTED» and atso 
may be processed by procedures PACK and UNPACK. 


cors or c name of CORection Set{s) to be applied against a 
base for maintaining correction: histories. 


nb or ni name of a New Base or New Library, used in those 
procedures that perform ooerations that permanentiy 
alter a bases requiring that a new base be created. 
An explanation of the method used to update a base 
is contained in a subsequert section. 
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PROFILE Variables for Source Text Maintenaace 


The variables described betow may be dectared in your PROFILE in 
order to establish default information for the parameters of the 
source text maintenance procedures. 


base name of base library where modules: ar‘’e to be found or 
replaced. 


baseown user name in whose catatog the base is to be found. 


newbase name of new base iibrary for those orocedures which update 
a base librarys thereby creating a new one, The default 
name for newbase is the same name as the old base. 


cors used by alt procedures as sane of fite containing 
CORrection Sets to be applied to a base. The default name 
for this file is cors. 


group used by all procedures to designate a group files or a file 
containing modules in source fornats one nodule per togical 
record. The default name for grouo is group. 


cfseq used by GENCOMP to indicate whether to place sequence 
numbers on the compile file. If vou wish to use this» 
deciare it as seq. . 


cefwidth used by GENCOMP to specify the width of the compile file. 
The default value for this is 119.) 


sestmpb used by all of the procedures that update bases to specify 
the temporary base fite during the update process. The 
default name for this file is sestmupb. 


flokmode used by all of the procedures that update basess to 
determine the defauit interlock action.’ ltokmode may be set 
to one of *LOCK' or *NOLOQOCK*. See also the sections below 
on updating bases and interlocking. 
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intrlok used by af! of the procedures that update bases or 
libraries to specify the interlock: fide to be used during 
the update processe The default name for this file is 
intrlok. 
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Base Updating Process 


Some of the source text maintenance procedures physically altter a 
bases requiring that a new base be created. The process is common 
to ali such proceduress and is as follows 3. 


If you code both the b and nb parameterss the new base is created 
simply by performing the required operations on the ofd bases and 
writing the newly created base onto the file soecified by the nb 
parameter. 


If you code onty the b parameters the uodate takes piace in two 
Stages. The updating operation is performed and the new base 
written to a file called sestmpb (SES TeMPorary Base). sestmpb is 
then physicality copied back over the file specified by the ob 
parameters and finally sestmpb is purged. 


Note that if the file specified by the nb for b if nb is omitted) 
does not already exists a DIRECT access READ mode file is DEFINEd 
for the base (thiss of courses can onty bea done if the owner of the 
base is the current user). 


Note that if anything goes wrong during an updating runs the 
originat base is atways left iIintacts and onty the new base or 
sestmpb is potentially incorrect. This means that you can recover 
by purging the new base or sestmpb and starting the run again. If 
something goes wrong before the base aopears on sestmpbs the 
original base is intact» and sestmpb nay be ourgeds whereas if 
something goes wrong after the new base is on sestmpbs that is» 
during the "rewrite" phase of the updates it is sestmpb that is 
safes and the oid base that is wronge In this cases you may use the 
REWRITE procedure to do the rewrite agains or alternativelys you may 
just purge the old bases then change the nane of sestmpb to be the 
base name. 
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Interlock Process for Updating. a Base or Libcarcy 


When updating a base or library you can Interlock the update so 
that only one user at a time can update the base or library. Those 
procedures that update a base or Jibrary are set uo so that if the 
base or library to be updated is in another’ user's catalogs the base 
or library is interlocked by default. You can override default 
actions by defining a fokmode variable in your profiles or by coding 
a tock or nolock key on the procedures as shown In the diagram on 
the next page. 


Interlocking of a base or fibrary is dove via an intertock file. 
Such a file must be a DIRECT access file in the same user's catalog 
as the base oc Library being uodated. Naturally the interlock file 
must be a PUBLICs WRITE MODE file if other’ users are tikely to be 
using ite The default name used by the SES source code maintenance 
and library management procedures for the lock fite is intrtok. You 
can have an interlock file of any nane by defining the intrtok 
profile variables or by coding a file name as a value for the tock 
parameter on the appropriate procedures. 
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! Coded Qo ! ee 
i Procedure ! Action Taken ’ 
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H lock : library or base is locked regardiess of contents of 3} 
H ; tokmode profile variable or other conditions. : 
fe ae ae ae ca ee cae cee cee ae ae a ee a SD ne a seve a nam ofp 
; holock ; tibrary or base is not tocked regardiess of contents } 
H $ of lokmode profile variabie or other conditions. ; 
ne a ce ce are ca cee eae ae hh ae ee eee cee ee a ce na ce ee ee ee ee ep ee OD DE Se nee nD emt ee ae a a woe eee 
+ Nothing : Coded in Profile : | Action Laken ; 


\ tlokmode="*LOCK? ¢: tibrary or base is locked 
: unless overridden by notock 

3} parameter on procedure. 
fe se a con a cs ea em in GO Ss ee cn Se a a se aL OC SO A ES SA SO: SO en SS a 
\ lokmode="NOLOCK® :{ tibrary or base ts got tocked 
; unless overridden by lock 

3; parameter on procedure. 
$e wn wn $e ee nn fe ew an fo nn on ee ee ne ene $ 
: > Quner OF Base : ' 
} Nothing : Oc Library : Action Taken i 
ee re ec ce ee we hee ee ee ee 2 oe ee ee ee) an ee ae en 0 ee ae ae ee ee ee ee ee en ee 
Current User i: tibrary or base jis pot 
flocked untess the tokmode 
profile vartable is set 
to '"'LOCK*® or the tock 
parameter is coded on the 
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+> ED DD AD ODED D-DD ED a cn te ee ee ee ee ee ee ee 
Another User i library or base jis tocked 

i untess the tokmode 

$ orofile variable is set 

$ to "NOLIC<%* or the notock 
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§ 9rocedure 
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Sel GETMOD OR GETMODS = EXTRACT MODULE GROJP_EROM_ BASE 


GETMOD and GETMODS are synonyms for a orocedure designed to 
extract a designated group of modules (or all moduftes) from a MADIFY 
librarys and place the extracted modules 92 a MADIFY “source™ format 
files that iss each extracted module occupies one togical record on 
the “source™ file. Parameters to GETMO0(S$) are 3: 


moor ali: 
Coding the all key indicates that ALL modules are to be 
extracted from the specified bas2. The w® parameter refers 
to a module or list of modules to he extracted. Ranges of 
modules may also be specified. 


g or group : 

(optional) name of file to receive the modules extracted 
from the base. If you dontt' code the g parameters, 
GETMOD(S) uses the value of profile variable group as the 
group file names and if there's 19 such variable defined, 
GETMOD(S) uses the name groun as the name of the group 
File. See the note on GROUP files at the beginning of 
this section. 


bor 1 3: 
(optional) name of Base Library from which modules are to 
be extracted. If you don't code the »b Parameters 
GETMOD(S) uses the value of profile variable base as the 
name of the base ftibrarys and if there's no such vartiabte 
defineds GETMOD(S) uses the name base. 


oe 


un 
(optional) User Name in whose catalog the base specified 
by b is to be founds if b is not in the catalog of the 
current usefre If you don"t code the un parameters 
GETMOO(S) uses the value of profile variabie baseown = as 
the user name from whose catafog the base is to be 
obtaineds and if there*s no such variable defineds 
GETMOD(S) uses the current userts catalog.: 


cors or c 3 
{optional) is a file containing a CORrection Set to be 
applied against the base b before the module m is 
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extracted. If you code this parameters SES procedure 
TEMPCOR is used to apply a TEMPorary CORrection sets Note 
that TEMPCDOR doesn*t actuatly alter the bases the 
correction set is only applied for the duration of the 
GETMOD(S) run. 


wor width : 
(optional) maximum Width of modules retrieved. 


status or sts : 

these (optional) keys can be used for those cases where 
GETMOD(S) is being used as a buitding block of more 
sophisticated procedures or jobs.» The status keys cause 
GETMOD(5) to set the NOS job contro! register EFG to the 
value zero if GETMOD(S) successfully completeds and to non 
zero if anything went wrong during the run of GETMOD(S). 
If status is not specifieds the orocadure will EXIT if an 
error occurSe 


msg or nomsg : 
these (optional) keys contr! the generation of 
informative messages by this orocedure and are fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 


Examples of GETMOD(S) Jsage 


sesegetmods (Couttinds timitsd.-oprtypks ststypks symentdeesymk) 
REVERT. END GETMODS GROUP <= BASE 


This example shows GETMODS used to extract a bunch of modules from a 
basee Modules outlinds all modules timitsd through oprtypk,s module 
ststypks and all modules symentd through symk are extracted. Every 
parameter to GETMODS is set to its default vatue. The modules 
appear on the file group. 
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sesegetmods ali bzecidbase un=dt73 g= junk: 
REVERT. END GETMOQDS JUNK <= CIDBASE: 


This example extracts ALL modules from bas2 cidbase in the catalog 
of user dt73 onto a group file junk 


Note ;3 A possible method of using this 2rocedure is to extract a 
group of modules using GETMQDS» to edit those modules using MULTED>» 
and finally to replace the moduies in the base fibrary using REPMOD. 
For example ; 


sesegetmods all becidbase3; multed; repomods bzcidbase 
The exampte gets all modules from base cidbases uses procedure 


MULTED to edit the group file (MULTED*s default input file name is 
group)» then replaces all the modules on cidbase again. 
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5el GETMOD GR GETMODS — EXTRACT MODULE GRIYUP FROM BASE 


Data _flow of GEIMOD{$) usage 


he & see es ee ce ape co 
Pe SESE ESE SE TS tS Ff 4 


GROUP 


BASE ----------~----->! GETMOD(S) {-!-----------> (extracted 
> 


E ] 
3 (extract $ 
3 modules) 


* 


pow an” wewem $ 


/ 


BRBVLAVWISIAtZSZsTESAzASTE 
 CORS 
(correct ion. -<-<erseeese ree eent 

sets) 


t 
Pe se FPS? Sf EE ES FS 


2h OO 26 wee ee 


modules) 


GETMOD(S) is a fairly simple process : a tist of modules is 
extracted from the base ltibrarys and appear on file group in MADIFY 
source forms that iss one noduie per togica! record. An optional 


correction set (the 
the base before the modules are extracted. 
applies the temporary correction sets. 


cors parameter) may be apolied temporarily to 


Procedure TEMPCOR 
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502 REPMOD OR REPMODS ~_ ADD OR REPLACE MODULES 


REPMOD and REPMODS are synonyms for a orocedure for adding or 
replacing modufle(s) on a basee Parameters to REPMIN{(S) are 3: 


(optional) tist of Modutes to bea added to or replaced on 
the base. If you don't code the parameters REPMQD(S) 
assumes that the module({s) to b2 added or replaced are on 
the group file specified by the 9 parameter. Note that 
each file specified by the m parameter is treated as a 
MADIFY source File (or "group™ file) with exactly ane 
module on it. See the note on GRIP files at the 
beginning of this section. 


g or group : 
(optional) name of the group file to be used to accumulate 
the modules. If you don't code the g vparameters, REPMOD(S) 
uses the vaiue of profile variable group as the group file 
namey and if there's no such variable defineds, REPMOD(S) 
uses the name group for the grouo file. See the note on 
GROUP files at the beginning of this section. 


bor i: 
(optional) name of Base Library to be updated. If you 
don't code the b parameters REPMI9(S) uses the value of 
profile variable base as the name of the base library» and 
if there's no such variable defineds REPMOD{IS) uses the 
name basee 


nb or na? 
(optional) name of the New Base to receive the updated 
fibrary. If you don't code the nb parameters REPMOD{S) 
uses the value of profile variable newbase as the name of 
the new base tibrarys and if there's no such variable 
defineds, REPMOD(S) uses the name of the base tibrary 
specified by the b parameter. 


un 3 
(optional) User Name in whose cataltog the base specified 
by b/nb is to be founds if b/nb is not in the catalog of 
the current user. If you don*t code the un parameters 
REPMOD(S) uses the value of orofile variable baseown as 
the user name from whose catalog the base is to be 


5-16 
COC =- SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REY: 4A 
5.0 SOURCE TEXT MAINTENANCE 
522 REPMOD OR REPMODS - ADD OR REPLACE MODULES 


SO A A AS A EN AAS NN ED AD AN DD EN A AS EE ED ANS END I ES EN A A AE OUND AES AE SOND ANT “SAR AED Se RESO AT OD NNT ONY OD “AE NS AND AA SY SANS ANN ED SAN AS NN AED NS AD AED “AD ED SAE ONS 


obtaineds and if there*s no such variabte defined, 
REPMOD(S) uses the current user*s catalog. 


woor width or inwidth : 
(optional) maximum Width of the inout modules. 


flock or nolock : 

these (optional) parameters deternine whether the base 
update process is interlocked against simuttaneous updates; 
coding a filename for the tock: parameter determines the 
name of the interlock file. Interlocking is the defaguit 
action when the base being updated is in another user's 
catalog. If you don*t code either of the tock or nolock 
keys» intertocking is controifted by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the flock and notock parameters. If 
you don't code a filename for the tock parameters the 
contents of profile variabte iIntrtok ts used as the 
interitock filename; if there®s no such profite variables 
the name intriok is used as the tock filename. The 
interlock file must be in the same catalog as the base 
being updated. If the intertock file cannot be founds the 
procedure aborts. 


batch job parameters : 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in tocal nodes but It can be run in 
batch mode. The dayfile parameter is not used by this 
proceduree 


msg or nomsg ? 
these {optional) keys control: the generation of 
informative messages by this orocedure and are “fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES", 
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Examples of REPMOD{(S) Usage 


seserepmod (hertzs maxwelts marconi)s b=r‘adios nomsg 
REVERT. END REPMOD GROUP => RADIO 


This example shows three modules being coltected onto aie group 
File group (the default)» replaced on the base calfted radio. Since 
the nomsg key is codeds no informative messages are output during 
the run of REPMOD. 


seserepmods (grabs hoid) b=ziitch g=temp w280 fock msg 
GRAB -> TEMP 

HOLD -> TEMP 

LOCKING ZILCH VIA INTRLOK 

ZILCH LOCKED 

REPLACING/ADDING MODULES ON ZILCH 
NEW BASE ON SESTMPB 

NEW BASE NOW GN ZILCH 

SESTMPB PURGED 

BASE ZILCH UNLOCKED 

REVERT. END REPMODS TEMP => ZILCH 


eH HR HH HH 


This example shows two moduies being reptaced on the base ziitch 
through a group Pile temp. The width of the input lines is limited 
to 80 (ASCII) characters (because of the w parameter). Because the 
fock key was codeds the base is ltocked during the run using file 
intriok (the default). Informative messages are output during the 
REPMODS run because the msg key was coded. 
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Creating. a_New Base with REPMODIS) 


If you are creating a brand new base fron scratchs you use 
REPMOD(S) stighttly differentiy from the nornal cases in that you 
code a b (base) parameter and an nb (new base) oarameters but the »b 
parameter refers to a non existent bases as in this example 3 


seserepmods (yorkshunt) bznonsuch nbznewstuf 
* YORK -> GROUP 

¥. HUNT => GROUP 

* CREATING NEW BASE NEWSTUF 

¥ NEW BASE ON NEWSTUF 

REVERT. END REPMODS GROUP => NEWSTUF: 
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Data flow of REPMODIS) process, 
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REPMOD(S) takes modules from a group file (whichs as shown in the 
diagrams could well have come from the old bas2 in the First place)s 
and replaces (or adds) them to produce either a conpletely new bases» 
or rewrites the result over the old base. 
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5e3 COLLECT = COLLECT MODULES) TO_BUILD_A_G&OUP_EILE 


COLLECT is useful in conjunction with source text maintenance 
procedures such as REPMOD(S). COLLECT builds a group file by 
COLLECTing modules of a specified types adding in the module name 
and COMMON tiness (and copying the modules to a group file. Also» 
COLLECT can accumulate members of different types onto the group 
files and so may be used in conjunction with the tibrary management 
procedures described in another section. Parameters to COLLECT 
are 3 


moor mem or mems or member or members : 

(optional) tist of Members tno he accumulated onto the 
group file. When used in conjunction with other Source 
Code Maintenance procedures, CIULLECT assumes that files 
specified with the m parameter already have the deck name 
as the first fine of the file Cand COMMON as the second 
line for a common deck). Note : If the file specified by 
the m parameter is a multi record files COLLECT does . 
gather gli records in the file. This capability is ngt 
available with the c andr parameters as it is not truly 
applicable in those cases. 


c or com or opic 3 . 
(optional) tist of COMmon modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text files,» and so COLLESTT places the module name 
and COMMON tines at the start of the nodule. 


r or reg or opt 3: 
{optional) tist of REGuiar modules to he accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text filess and so COLLECT places the module name 
fine at the start of the module. 


g or group : 
(optional) name of group file onto which the member(s) or 
module{s) are to be accumulated.’ [If you dontt code the g 
parameters, COLLECT uses the value of oprofile variable 
groups, and if there's no such variable defined in your 
profiles COLLECT uses the filenane group. 


mSg or nomsg : 
these (optional) keys control the generation of 
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informative messages by this orocedure and are “fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*". 


Examples of COLLECT Usage 


sesecoifect czl(cdcs icls ibmds rz(sdcs ifs» csc)s geacronym 
CDC/COM => ACRONYM 

ICL/COM => ACRONYM 

IBM/COM =—-> ACRONYM 

SOC/REG => ACRONYM 

IFS/REG => ACRONYM 

CSC/REG =—> ACRONYM 

REVERT. END COLLECT ACRONYM 


ee 


This example shows six straight text files being collected onto a 
group file acronym. The first three are specified as common modules 
(the c parameter), so COLLECT adds the module name and COMMON dines 
at the front of the file before adding it to the group File. The 
last three are specified as regutar moduies (the er parameter)s so 
COLLECT adds the module name tine at the start of each one before 
adding it to the group file. 
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Data_flow.of COLLECT processing 
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As shown in the diagrams COLLECT takes files designated as either 
regular or common modutess and gathers them onto a group file. 
COLLECT can also just gather up records which already have header 
information in them (the m parameter). 
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304 GENCOMP _=_GENERATE COMPILE FILE FOR MIDJLEC3) 


GENCOMP generates a compile file for a module or ae group of 
modules. Oniy reguiar modules can be GENCOMPed. The GENCOMP 
process resolves calis to common modules (including nested calls) 
according to the following “compile file” directives : 


*CALL module 
This directive unconditionally calls the specified common 
modules 


*CALLC module 
This directive only calls the spaciffied common module if 
it has not already been called within the current regular 
module. The information about which comnon modules have 
been calfted is cleared at the end of processing each 
regular module. 


*IFCALL name module 
This directive ontiy calis the soacified common module iif 
the specified name has been defined {see the define 
parameter described below). 


*NIFCALL name module 
This directive only calits the specified common modute if 
the specified name has not been defined (see the define 
parameter described betow). 


GENCOMP permits the specification of a list of atternate bases 
from which to resolve common deck catits (or in which to find modules 
to be GENCOMPed). Also» a source file nay be specified which 
contains source for modules {or common nodules) to be used in the 
GENCOMP processe In additions correction sets may be applied oprior 
to the compite file being generated. 


When generating the compile files, MADIFY searches for decks in 
the following order ? 


- If the SF parameter is codeds the specified file is searched. 

- If the AB parameter is codeds the snecified files are searched 
from right to left. 

- If the CYBCCMN or CYBICMN par ameter is codeds the designated 
common deck base is searched. 

- Finallys the base specified by the 3 oaraneter is searched. 


Parameters to GENCOMP are 3: 
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moor ala : 
This optional) parameter specifies a list of modules 
(including ranges of modules) for which the compile file 
is to be generated. If the all key is codeds a compile 
file for ALL of the (regular) nodules in the specified 
base(s) are produced. If you dontt code the m parameter 
at ail», you must code the sf paraneter (see below). 


cf 2. 
(optional) name of the Compile Fite to be generated. If 
you don't code the cf parameters GENCOMP writes the 
compile file to a file called conoitea,! 


bor | : 
(optional) name of Base Library from which to generate the 
compile file. If you dontt code the b parameters, GENCOMP 
uses the value of profile variable base as the name of the 
base librarys and if there's no such variabie defined» 
GENCOMP uses the name base. 


oe 


un 
(optional) User Name in whose catalog the base specified 
by b may be founde If you dontt code the un parameters 
GENCOMP uses the value of profile variable baseown as the 
name of the base librarys and if there's no such variable 
defineds GENCOMP assumes that the hase is in the current 
user's catalog. 


ab or af 3 

(optional) tist of Alternate Bases from which to satisfy 
calis to common modules. The ab parameter may be coded as 
a multi valued tist of sublists.: Fach element of the 
value fist is either a single names in which case it 
refers to the name of an alternate base already assigned 
to the jobs or in the current user's catalogs or an 
element is a sublists in which cases the last sub element 
in the subtist is a user name in whose catalog the bases 
referred to by the other sub elenents of the sublist may 
be found. The exampte at the end of this description 
should (with fuck) make this clear. 


sf : 
(optional) name of a Source File containing source text 
for one ofr more modules or connon nodules that are to be 
used in place of or in addition to the modules on the 
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cors oF 


specified base(s). If the sf parameter is givens the file 
it specifies is the object of a *CREATE directive to 
MADIFY.» Note : that if you don?t code the m parameter 
(described above)» GENCOMP assumes that the file specified 
by the sf parameter contains one ({(regufiar) module and 
thats unlike the normal case for’ a MADIFY source modules 
its first line is not the module name but is the first 
fine of data in the module (in this case a defauit module 
name of SESOPT is used). If vou: don?t code the sf 
parameters you must code the m parameter. 


c 3 

(optional) name of file containing CORrection Sets to be 
temporarily applied against the base b vorior to generating 
the compite file. If you code the cor’s parameter,» GENCOMP 
uses procedure TEMPCOR to make thea temnorary corrections 
before generating the compile file. 


seq or noseqg ; 


(optional) The default for GENT IOMP is NO SEQence numbers 
on the compile files and a comoifte file width of 100 
(ASCII) characters. You can sode noseqzevailue to change 
the widths or you can code seq to get SEQuUence numbers at 
a width of 100 characterss or you can code seqevaiue to 
get SEQuence numbers at compile File width of vatue 
characters. You control the sequence nunbers and width by 
defining the profite variables cfseq and cfwidth. 


define or def : 


this (optional) parameter specifies a name or tist of 
names to be *DEFINEd for refarence by the *IFCALL and 
*NIFCALL “compile file™ directives described above. 


status or sts : 


these (optional) keys are used for those cases where 
GENCOMP is being used as a bultding block of more 
sophisticated procedures or jobs. The status key causes 
GENCOMP to set the NOS job contro! register EFG to the 
value zero if GENCOMP successfully conpleteds and non zero 
if anything went wrong during the run of GENCOMP. If 
status is not specifieds the procedure will EXIT if an 
error occurs. 


cybcemn or cybicmn : 


(optional) key specifies an of SES supplied Alternate Base 
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for use in satisfying catis to conmon modules {see the ab 
parameter described above). If you code the cybccmn key» 
the base containing CoMmoN modules for use by CYBIL CC 
programs is selected. If you code the cybicmn keys the 
base containing CoMmon modutes for’ use by CYBIL CI programs 
is selected. By defaults no base is selected for use in 
generating the compile file. 


nest or nonest : 
these loptionat) keys control whether nested calls to 
common modules are processed or tgnored. If you omit this 
parameter or code the nest keys» SENCOMP processes nested 
calis to common decks. If you code the nonest key GENCOMP 
treats nested calis as ordinary lines of text. 


mSg or nomsg ; 
these (optional) keys control. the generation of 
informative messages by this oerocedure and are fully 
described in the section entitited "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*®, 


nodrop : 
if this (optional) key is codeds it specifies that an 
"unknown" common deck (one that couldn't be found during 
the compiie file generation) is not considered to be an 
error, otherwise it is. Note <: other errors are aiso 
ignored if nodrop is givens so use this feature at your 
own risk. 
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Examples of GENCOMP Usage. 


sesegencomp nextinr 
* GENERATING COMPILE FILE NEXLINR 
REVERT. END GENCGMP COMPILE <= QURBASE 


This example shows the simpitest use af GENCOMP, =generating a 
compile file for a module nextinr. Since the m oarameter of GENCOMP 
is the first positional parameters we can onit the m keyword. There 
is no base specified in the example since there is a directive 
like 3 


\ base = *QURBASE? 


in our profile. When GENCOMP has finisheds the generated compite 
file appears on the file compile. The next examote is more 
complicated, it shows the use of multiple mnodutes and alternate 
bases used to generate the compiie file. 


sesegencomp (Casterixs obelix..getafix)s hbagauls ab=(haspseecre 
eo? (grasps cicss powers if69)s milos) 

* GENERATING COMPILE FILE COMPILE 

REVERT. END GENCOMP COMPILE <— GAL 


This example generates a compile file For modules asterix»s and 
all modules obetix through getafix in the base cailed gaul. 
Alternate bases hasp and milos are to be obtained From the current 
user's catalogs and alternate bases grasp» cies and power are to be 
obtained from the catalog of user Ur69. The convoile file appears on 
file compile. The examplte aiso illtustrates the use of continuation 
liness showing the multi valued ab parameter split across lines. 


sesegetmods {specials general)» bz=theorys nuited; ee 
ee? gencomp (specials general)s cfsalberts sf=egroups ee 
ee? batheorys defineziorentzs seqz79 

* GENERATING COMPILE FILE ALBERT 

REVERT. END GENCOMP ALBERT <= THEORY’ 


In this example modutes special and general are extracted from 
base theory onto file group and edited. Then a compile File is 
generated for the edited version of the modules (via the sf 
parameter) with the torentz “option™ defined. The resuiting file 
albert will have sequencing information to the right of column 79. 
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Data flow of GENCOMP usage 
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correction sets 


GENCOMP generates a compile file for modules which may come from. 
off the base (the m parameter)» or from a source file (the sf 
parameter), or from both places. The ab parameter svecifies a tlist 
of aiternate bases to be used to get common decks from. A temporary 
correction set may be applied (the cors par‘anetear) via the TEMPCOR 
procedure before generating the compile file. 
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5e5 GENCOR OR GENCORS = GENERATE CORRECTIOV_SETS 


GENCOR and GENCORS are synonyms for a procedure that GENerates a 
CORrection Set for a modute. Parameters to SENEOR(S) are 2: 


name of the Modufe within the base tibrary b for which the 
correction set is to be generated. Alsos mis the default 
name of the file (either tocal or tn your catatog) which 
contains the new version of the nodule (see the sf 
parameter described betow). 


bor |: 
(optional) name of Base containing the module specified by 
m for which the correction set is to be generated. If you 
don'tt code the b parameters GENCOR(S) uses the value of 
profile variabite base as the nana of the base tibrarys and 
if there's no such variable defineds SGENCOR(S) uses the 
name base. 


un 3 
(optional) User Name where the base library specified by b 
is to be found. If you don*t code the un parameters 
GENCOR(S) uses the vatue of profifte variable baseown as 
the user name in whose catalog b is to he founds and if 
there's no such variabie defineds GENCOR(S) assumes” that 
the base fibrary is in the current user's catalog. 


cors or c ? 
{optional) is a file containing a CORrection Set to be 
applied against the base 6b before the module om (“is 
extracted. If you code this ovdarameters, SES procedure 
TEMPCOR is used to apply a TEMPorary CORrection set. Note 
that TEMPCOR doesn*t actuatiy alter the bases the 
correction set is onty applied for the duration of the 
GENCORS rune 


neors or arc 3 
(optional) name of file to receive the New CORrection Set. 
If you don't code the ne parameters SGENCOR{S) uses the 
name necors for the new correction set File. 
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sf 


(optional) IDent name for the GENCORS *IDENT directive in 
the generated correction set. id can be any character 
string that forms a vatid MODIFY correction identifier. 
If you don't code the id parameters GENCORS generates a 
unique correction set identifier. 


this (optional) parameter specifies the name of the file 
containing the new version of the nodule. If you dontt 
code the sf parameters GENCOR(S) uses the name specified 
by the m parameter as the Source File nane. 


is or ignoris : 


fi 


these (optional) keys specify whether or not to JGNORe 
Leading Spaces on lines being comnoar'ed.! The default action 
is to recognize teading spaces (the #s option). If you 
code the ignorts keys GENCOR(S) iqnores leading spaces on 
text lines. 


{optionat) parameter to increase the Field tength. IF you 
don't code the £1 parameters GENE VRAIS) defauits to a field 
length of 100K. 


msg or nomsg : 


these {optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*®. 


Example of GENCOR(S) Usage 


sesegencors mznices bzneats un=by73s neczcorset 


* 


GENERATING CORRECTION SET FOR NICE ON CORSET 


REVERT. END GENCORS NICE -—> CORSET 


This example shows a correction set being geanerated for module 


nice. 
by73. 


The original module is in base neat in the catalog of user 
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Data_flow.of GENCORIS) 
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The picture shows the flow of GENCOR(S). The file containing the 
new module M is in the user's catalog.’ The ofd version of the 
module is in the base Be An optional tenoorary correction set 
{CORS) may be applied if desireds in which case GENCOR(S) uses the 
TEMPCOR procedure to apply the correction set before generating the 
new correction sets which appears on the File svoecified by the ncors 
parameter. 
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96 TEMPCOR -_ MAKE TEMPORARY CORRECTIONS [TO _BASE: 


TEMPCOR makes temporary corrections to 34 base tlibrarys without 
permanentiy updating the Jibrarys providing checkout of the 
corrections applied before permanent modifications are made. 
Parameters to TEMPCOR are 3: 


bor f : 
name of Base Library against which the corrections are to 
be applied. If you don't code the b parameters, TEMPCOR 
uses the value of profile variable base as the name of the 
base fibrarys, and if there's no such variable defined, 
TEMPCOR uses the name base. 


un 3 
(optional) User Name in whos2 catatog the base library 
specified by b may be found. If vou don*t code the un 
parameters, TEMPCOR uses the value of profile variable 
baseown as the user name where b may he founds and if 
there's no such variable defined» TEMPCAR uses the current 
user's catalog. 


cors or c 3? 
name of file containing the CRection$ to be applied 
against b. 


msg or nomsg : 
these (optional) keys control. the generation of 
informative messages by this procedure and are “(fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Example of TEMPCOR Usage 


sesetempcor bzhisbases un=nr06s cecorsets: 
* CREATING TEMPORARY BASE 

* TEMPORARY BASE NOW BEING USED 

REVERT. END TEMPCOR CORSETS -> HISBASE 


This example shows the correction set corsets being applied to 
the base hisbase. The base hisbase is teft tocal to the jobs such 
that further references to hisbase actually use a temporary copys 
and not the original. 
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507 MODIFY -_UPDATE BASE WITH CORRECTION SET(S) 


MODIFY is intended to take a correction set file and update a 
base library with the correction sets contained therein. Parameters 
to MODIFY are 3 


cors or c or i 3 | 
name of file containing the CORrection Sets) to be 
applied against the base specified by the b parameter. If 
you dontt code the cors parameters MODIFY uses the name 
corse 


bor 4 3 
(optional) name of Base to be undated from the correction 
set File. If you don't code the b oarameters MODIFY uses 
the value of profile variable base as the name of the 
bases and if there's no such variable defined, MODIFY uses 
the default name base. 


nb or ni 2? 
{optionat) name of New Base to bea created when the update 
has been completed. If you dontt code the nb parameters 
MODIFY uses the value of profile variable newbase as the 
name of the new bases and if theretfs no such variable 
defineds MODIFY writes the new hbase over the old base 
specified by the b parameter. 


this (optional) parameter specifies the Jpotions to be used 
when producing the Listinge Each designator selects an 


option to a maximum of seven options. The designators 
must not be separated. Designators are: 

a fist active tines in deck 

c list directives other than INSERTs DELETEs RESTOREs 


MODNAMEs I» or 0 

list deck status 

fist errors 

jist inactive fines in deck: 
fist modifications performed 
include statistics on tisting 
fist text input 

jist compite file directives 


zeruvuva<"0 2 
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(optional) User Name in whose catalog the base specified 
by b/nb is to be founds if b/nb is not in the catalog of 
the current user.» If you dontt code the un parameters 
MODIFY uses the value of profile variable baseown as the 
user name from whose catalog the base is to be obtained, 
and if there'*s no such variable defineds MODIFY uses the 
current user's catalog. 


jock or nolock 3: 

these (optional) parameters determine whether the base 
update process is intertocked against simuitaneous updates; 
coding a filename for the tock oarameter determines the 
name of the interlock file. Interlocking is the dgefgult 
action when the base being updated is in another user's 
cataloge If you don*t code either of the tock or notock 
keyss interlocking is controlled by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nolock: parameters. If 
you don't code a filename for the tock parameters, the 
contents of profile variable intritok is used as the 
interlock filename; if there's no such orofite variables 
the name intrliok is used as the tock filename. The 
interlock file must be in the sane catalog as the base 
being updated. If the interlock fille cannot be founds the 
procedure aborts. 


batch job parameters : 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH JD985". The default for this 
procedure is to run in tocal modes but ft can be run in 
batch mode. The dayfite paraneter ts not used by this 
procedure. 


msg or nomsg 3 
these {optional) keys contro! the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Exampte of MODIFY Usage 


sesemodify b=dusbase czcorsiib 

* APPLYING CORSLIB TO DUSBASE 

¥. NEW BASE GN SESTMPB 

* NEW BASE NOW ON DUSBASE 

*. SESTMPB PURGED 

REVERT. END MODIFY CORSLIB —-> DUSBASE 


This example shows a correction set file calied corstiib 
against a base library calied dusbase. 


applied 


5-37 
CDC - SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Uaeen se a tdbook REV: 4A 
5.0 SOURCE TEXT MAINTENANCE 
528 CATBASE - PRODUCE LIST OF MODULES IN A BASE LIBRARY 


AD ANN AND ABN ND RO AUN NP cn HN SD Sa OD UN AUR ANE OE UT DR SENS REND “END AD TE ENED AN ED AOU END AT END AED AUD UR EON NY Aa AD AED OAD ED ED A OED SND UD AD ND AN SUD D-NY SE ce ee ye a 


508 CATBASE_=_PRODUCE LIST OF MODULES_IN_A_BASE_LISRARY 


CATBASE is used to display a tist of the modules in a base 
library. CATBASE outputs the modules list in a condensed formats 
four modules per tines showing only the module names and their type. 
Parameters to CATBASE are 3 


bor f : 
(optional) name of Base Library which is to have its 
module names displayed. If vou: dontt code the b 
parameters CATBASE uses the value of profite variable base 
as the name of the bases and if thereats no such variable 
defineds CATBASE uses a file name of bases 


un : 
{optional) User Name in whose catalog the base specified 
by the b parameter is to be found.» If you don't code the 
un parameters CATBASE uses the value of orofile variable 
baseown as the user names and if there's no such variable 
defineds CATBASE uses the current user's cataloge 

0 3 


(optional) name of file to receive the Qutput from 
CATBASE.» If you don't code the o parameters, CATBASE 
places the modute tist on file outonuwt.: 


short or tong : 
these (optional) keys determine the format of the output 
from CATBASE. If you omit this oarameter or code the 
short keys CATBASE produces its output in the form shown 
in the example below. If you code the fong keys CATBASE 
produces its output in the same format as the NOS utility 
CATALOG. 
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Exampie of CATBASE Usage 

sesecatbase bzdusbase unzvb55 
DOUSERM.-OPL DUINTRO. -OPLC. DUPRINT.'OPLC DUFORMT.*eOPLC 
DUSCODM.-OPLC. DULIBRM.-OPLC DUFILEM..20°LC DUCOMPL.eOPLC 
DUTEXTP.-OPLC DUMAILB.»-OPLC DUMULTT 22 GPLC DUCONVS.-OPLC 
DUGOGDY.-OPLC DUPROFL..OPLC DUMODES «+ SPLC DUMESGS..-OPLC 
DUSYNTX.-OPLC DUAQUIR. -OPLC DUXTRAC 2 HPLC DUDOMSG..-OPLC 
DUUPDAT.«eOPLC DOPLeeseeeeDPLD 

REVERT. END CATBASE DUSBASE 


library dusbase in the 


vb55. Regular modules are identified by the type 


and common modules are identified by the type code OPLC. 
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520 SQURCE TEXT MAINTENANCE 


509 LISTMOD = LIST CONTENTS OF _BASE 


LISTMOD performs two main functions : tos show vou what's in a 
bases and to get a printout of the modules in the base if necessary. 
LISTMOD first generates a cross reference of the bases showing which 
modules cali which modutess and which modutes are called by which 
modules (LISTMOD uses procedure XREFMOD to generate the cross 
reference - see the description of XREFEFMID if vou'tre interested). 
Lastiys LISTMOD generates a printout of af! modules or common 
modules in the base--you can suppress this iF you onfy want the 
cross reference without the whole base's csnteants. Parameters to 
LISTMOD are : 


bor ?t : 
{optional) name of Base to he vrocessed. If you dontt 
code the b parameters LISTMOD uses the vatue of profile 
variable bases, and if there's no such variable defined, 
LISTMOGD uses the default name base. 


{optionai) name of File to receive the Qutput from 
LISTMOD. If you don't code the o parameters a scratch 
File is used for the output and is returned once it has 
been printed. If you code the 0 parameter and LISTMOD is 
run in tocal modes the output is placed on the specified 
file and is pat printed unless the print parameter is 
given. 


un 3 
(optional) User Name in whose catalog the base specified 
by 6b is to be found. If you don"t code the un parameters 
LISTMOD uses the value of profile variable baseowns and if 
there's no such variable defineds LISTMOD uses the user 
name of the current user. 


batch job parameters ? 
These parameters are described in the section entitted 
"SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batch modes but it can be run in 
focal mode. The dayfile parameter is not used by this 
procedure. 


print : 
{optional) indicates how the outout of LISTMOD is to be 
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Printed. For the print parameter you may code any of the 
parameters to procedure PRINT. If you dontt code the 
print parameter at alls» LISTMOD pr‘ints one (1) copy of the 
output on the ASCII printer. 


short or common : 

these (optional) keys =controt®’ which modules are listed 
following the cross reference of the hase. If you omit 
this parameters LISTMOD fists the source for all modules 
in the basee If you code the conmon keys LISTMOD tists 
oniy the common modules from the base. If you code the 
short keys no modules are tlisted (ieeer» only the cross 
reference is produced). 


Examples of LISTMGD Usage 


seselistmod print=zcopies23s short 
11.17-34- SUBMIT COMPLETE. JOBNAME IS AVOPBIG: 
REVERT. JOB LISTMOD SUBMITTED 


This example shows LISTMOD processing the base whose name is 
contained in profife variable base. Three copies of the short tist 
{cross reference only) are produced. LISTMOD is run in batch» 
rather than interactively. Running LIST¥99 jin batch is the 
preferred modes, since it uses rather a large amount of resources. 


seselistmod bzcidbases oxrcidprins ecersie 

eo? print=(copies=2s hz*latest/version of f/cidbaset) 
10619257. SUBMIT COMPLETE. JOBNAME IS ACULBXG 
REVERT. JOB LISTMOD SUBMITTED 


This example shows LISTMOD run in batch to produce two printouts 
of the cross reference of base cidbases pius the text of ali the 
modules in cidbasee 
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5010 SORTMOD =_ SORT BASE. INTO ALPHABETICAL 22058 


SORTMOD rearranges a base such that al! the modules appear in the 
base in alphabetical order. This is a very useful facilitys for 
when a base becomes large and has a jlarge  unber of modules in its 
it's easier to find modules in the base if they're in some reguiar 
order. Parameters to SORTMOD are :. 


bor I ? 
(optional) name of Base to be sorted. If you donft code 
the b parameters SORTMOD uses the value of profile 
variable bases and if there's no such orofite variable 
defineds SORTMOD uses the name base. 


nb or ni: 
(optional) name of New Base to be created at the end of 
the SORTMOD run. If you dontt code the nb parameters, 
SORTMOD the value of profile variable newbase. If therets 
no such profile variable defineds SORTMOD writes the new 
base on the file specified by the b parameter. 


un 3. 
{optional) User Name in whose cataisg the base specified 
by b/nb is to be founds if b/nb is not in the catalog of 
the current usere If you dorv'?t code the un parameters 
SORTMOD uses the vatue of profile variahie baseown as the 
user name from whose catalog the base is to be obtained» 
and if there's no such variable defineds SORTMOD uses’ the 
current user's catalog. 


(optional) name of fite to receive the Qutput of the 
programs used to run SORTMOD. If you don't code the o 
parameter, SORTMOD sets of0» or Ao output. This is 
usually the desirabte defaults since the sort process 
generates iarge volumes of output.’ 


edtsort : 
(optional) pair of filenames resresenting the Input and 
output files for the EDT text editor. You use edtsort to 
EDIT the SORT output to impos? your own ordering on the 
modules in the base. 
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lock or nolock : 

these (optional) parameters determine s«ahether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock oarameter determines the 
name of the interlock file. Intertaocking is the defauit 
action when the base being updated is in: another user's 
catalog. If you dontt code either of the lock or notlock 
keys» interlocking is controlled hy the tokmode profile 
variable. Refer to the introductory sections of this © 
chapter for information on the interactions of the tokmode 
profile variabie and the tock and notock parameters. If 
you don't code a filename for the fock parameter, the 
contents of profile variabte intriok is used as the 
interlock filename; if there's no such orofile variables 
the name intrtok is used as the lock filename. The 
interlock file must be in the sane catalog as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


batch job parameters : 
These parameters are described ir the section entitled 
"SES PROCEDURES RUN AS BATCH J735". The default for this 
procedure is to run in tocal mode» but it can be run in 
batch mode. The dayfile paraneter’ is not used by this 
procedure. 


msg or nomsg ; 
these (optional) keys control. the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Sell HIPEMOD = DELETE MODULES) FROM BASE 


WIPEMOD is intended as a means of deleting module(s) from a bases 
Parameters to WIPEMOD are : 


bor i : 
{optional) name of Base fron which modute{s) are to be 
deleted. If you don't code the b parameters, WIPEMOD uses 
the value of profile variable base as the name of the 
bases If there's no such profite variable defineds 
WIPEMODD uses the name base as the name of the base. 


nb or ni: 
{optional) name of New Base to be created at the end of 
the WIPEMOD run. If you don't code the nb parameters 
WIPEMOD uses the value of profiite variable newbase as the 
name of the new base. If there's: 10 such orofile variable 
defineds WIPEMOD places the new base back over the old 
base specified by the b parameter. 


oe 


un 
{optional) User Name in whose catatog the base specified 
by b/nb is to be founds if b/nb is not In the catatog of 
the current user. If you don*t code the un parameters 
WIPEMOD uses the value of profile variable baseown as the 
user name from whose catalog the base is to be obtained» 
and if there's no such variable defineds WIPEMOD uses the 
current user's catalog. 


c or com or optic 3 
(optional) tist of COMmon module(s) to he deleted. 


f or reg or opl : 
(optional) tist of REGular or OPL nodule(s) to be deleted. 


fock or nolock :;: 
these {optional) parameters determine whether the base 
update process is interlocked against simuttaneous updates; 
coding a Filename for the tock: o.arameter determines the 
name of the interlock file. Intertocking is the dgdefguit 
action when the base being undated is In another user's 
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catalog. If you don't code either of the tock 


or notock 


keys» interlocking is controlled by the tokmode profile 
variabie. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variabte and the tock and nolock parameters. If 
you dontt code a filename for the tock parameters the 


contents of profile variable intrtok is 


used as the 


intertock filename; if there's no such profile variables 
the name intriok is used as the tock filename. The 
interlock file must be in the sane catalog as the base 
being updated. If the interlock file cannot be founds the 


procedure aborts. 
batch job parameters :. 


These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH JO85". The default for this 
procedure is to run in tocal nodes but it can be run in 
batch mode. The dayfite parameter Is not used by this 


procedure. 


msg or nomsg : 


these (optional) keys control. the generation of 


informative messages by this orocedure and 


are fully 


described in the section entitled "INFORMATIVE MESSAGES 


FROM SES PROCEDURES". 


Exampie of WIPEMOD Usage 


sesewipemod mybase cz=(cdeckas cdeckb) r=(main..streets comd) 


* DELETING MODULES FROM MYBASE 
* NEW BASE ON SESTMPB 

+. NEW BASE NOW ON MYBASE 

* SESTMPB PURGED 

REVERT. END WIPEMOD MYBASE 


This example of WIPEMOD defetes common nodules cdecka and cdeckb 
from the base mybase. I[t also deletes ragular mnodutes main through 


street inclusives and regular module comd. The example 
the sort of informative messages output by WIPENND., | 


illustrates 
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3e12 XREFMOD -_ CROSS REFERENCE OF _A_BASE 


XREFMOD produces a cross reference fisting of a hbasee (XREFMOD 
is primarily intended as a "buiiding block" for other procedures. 
In particulars see the description of the LISTMOD procedure «hich 
runs XREFMOD as a batch job.) 


Optionaitlys a single moduie (deck) name can be specified for 
which are produced linstead of the normal outout fisting) a fist of 
the regular modules that reference {cal!) the module either directly 
or indirectly (see the description of the m oarameter for more 
information on this feature). 


In the normal {(1.@es2 not the singte module option) mode of 
outputs XREFMOD produces for each MOODule (deck) the following 
information : 


1. the name of the deck 

22 the date on which the deck was created 

3e the type of deck (see deck categories described Selow) 

4. the number of tines in the deck 

5. the position of the deck in the base 

6-6 a fist of all the decks that reference (call) this deck 

7e a Jist of ali the decks that are referenced (called) by this 
deck 


Items 2 through 5 are replaced by a "flag" if the deck is 
"external™ to the base being cross referenced. An external deck is 
one which is referenced (calfted) by one or’ nore decks in the base 
but which is not itself contained in the base.’ A separate list of 
ali the external decks is produced following the main deck list. 


In items 6 and 7» a deck name may be preceded by IJ indicating 
an Indirect references and/or by ***® indicating an external deck. 


All deck tists are arranged in alohabetical order. The page 
width and page length are selectable via par‘aneters. 


5-46 
COC ~ SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
5.0 SOURCE TEXT MAINTENANCE 
5212 XREFMGD - CROSS REFERENCE OF A BASE 


TS AS A AS AEN SED A OO NN AE SS EES AED CED NI OURS SEND TD ND AD AN AED ED SD ~~ ORD AON OED TA AND ED A NE ADD NED «I OD OND ODED NE EST ~~ ED ARN ANY EDD CHRD SONNE LE GND SND NED SE OED ED aD 


Modules are categorized according to the follfowing criteria 3. 


: Category Jype ; Critecia*® : 
3 a 3 


ee ee ee ee oe oe ee ee oe ee ew oe +> SAD CA ED EE SED RS ED NED NE A EE ERD EN ND OD EE ND EE SR A AD SAD OR HD ED NN ED EC A a a + 


COMMON common deck 


A SD AMD AA EN AEE ED ae END <eD ae NE a ee PAP NAD AND AD ED ERD EN ERD END AND eee SE NR IND ANN “ES AED SN I AED ENED OND SORE AOD OND ACE AED ED UD ND MNS WEN ENDED EOD AEE ED ED ED AED NS END A ED A i A ee ea 


MODULE first program line Is a MODULE line 


> emp ab ae en aE eb el ae a a A A AD A EN A A A AS A ES NN ES AANA A T-Sh ea $0 ND ND al EN AT AED AED SED ag A AD ED GD AUD ARDS EN ED SED ND ND eae 


IDENT first orogram line is an IDENT tine 


Ce ee ee, ee eo eT 


ED ED els ve OUD AD Oe a eR es ED ME a + Sn ED A Ne ED 8 RD AEE RD DD ES A ES ED A A ED OD ae ee a ae ee a en ee a ee a ee 


PROGRAM first program line is a PROGRAM line 


ED AE Rs CES A A UE) OHS ON SI EN see SO ORT 2D OED ED OD Gy ES ED OD EE A es On  - ee A oe 2 OO ee 


SESPROC first two characters of the first program tine 
are "\ ', that iss the SES processor master 
c 


ontro! character followed by a space. 


p 26 ot we Oe > oe Oe ee ee ee ee Ob he oe hh Oe we ae op ee oe oe 


TXTFORM first character of the first tine is a reverse 
sant (\) 
KCL irst character of the first tine tis an asterisk 


f 
(*) and not immediately followed by "™CALL"s 
MCALLC™, "IFCALL™s or "NTFCALL"™, 


FA A RAE AED A UR aS ee A AEE GA UY ORD ate cee SE OE GS ED EP A OE ED 1 DO 2 Ot AE ES A GE EE an a en -  a D  O a a 


ccL First line is a «PROC Jine 


UNKNOWN (you guessed it) none of the above 


on ee ae > we we ee of we 68 we He  4e we 6 Oe 6 Oe ee ee ph ee ee bp we we a we ee hh ae Oe ee 


- 2* we we > on He 66 bb oe oe BY Oe om Be Om oe Oe ob ne Oe Be oe Oe ge Oe Ow 


+ Be SESE Se oe ee Se ee se ee ae 


' 
' 
j 
' 
' 
' 
' 
' 
' 
t 
' 
‘ 
} 
t 
' 
! 
t 
' 
t 
' 
j 
j 
' 
' 
i 
‘ 
j 
4 
' 
4 
' 
‘ 
' 
] 
' 
i 
' 
' 
‘ 
§ 
( 
4 
' 
i 
‘ 
t 
' 
' 
' 
' 


* Up to five fines are examined if the first separator character 
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of the previous fline(s) is a double guote (") or aiequestion 
mark (2). 


Parameters to XREFMOD are 3 


bor ?: 


un 


moor mod 


oo 


(optional) name of Base Library for which the cross 
reference is to be generated. If you: don*t code the 0b 
parameters, XREFMOD uses the value of profite variabie 
bases and if there's no such variable defined» XREFMGD 
uses the default name of base. 


{optional) User Name in whose catalog the base specified 
by the b parameter is to be found. If you don'tt code the 
un parameters XREFMOD uses the vatue of profile variable 
baseown as the user names and if there's no such variable 
defined» XREFMOD assumes that the base is in the current 
user's catalog. 


{optional) name of file to receive the Output From the 
cross reference rune If you don't code the o parameter » 
XREFMOD sends the output to file DITPIT. 


a 
s 


(optional) name of a module {possibly external) for which 
a fist of the regular modules that reference (call) it 
either directly or indirectly are oroduced. Each module 
name is written on a separate tine with a space in column 
ls the module name in columns 2 through 8 (left justified, 
space filleds with letters in upoer case) and a period (.) 
in cotumn 9. The module names are written in alphabetical! 
order. 


pw or pwidth : 


this (optional) parameter specifies the Page Width for the 
cross reference listings. If you code this parameters you 
must give a vatue of at least 70. If you omit the pw 
parameters XREFMOD uses a page width of 132. 


pl or plength ;: 


this (optional) parameter specifies the Page Length for 
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the cross reference listing. If you code this parameters 
you must give a vaiue of at feast 29. IF you omit the pi 
parameters, XREFMOD uses a page fenaqth of 60. 
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5013 GETCOMN = ACQUIRE CYBIL COMMON DECK LIBRARY’ 


GETCOMN acquires the latest MADIFY or SCJ ver’ston of the CYBIL CC 
or CI common deck library as a focal file named CY3CCMN or CYBICMN = 
parameters to GETCOMN are 3: 


mad or scu 3: 
this foptional) kay indicates the Format of the CYBIL CC or 
CI common deck tibrary desired. If you code the mad key» 
the MADIFY formatted version of the common deck fibrary is 
made focal. If you code the scu:' kay or do not code either 
of these keyss the SCU formatted version of the common deck 
library is made local. 


cc or ci 3 
{optional) key indicates the versior of the CYBIL common 
deck ftibrary is desired. If you code the ci: keys the MADIFY 
or SCU formatted CYBIL CI common deck library is made tocal. 
If no key is codeds the MADIFY or <‘SCU formatted CYBIL CC 
common deck ftibrary is made local. 


You may also define PROFILE variables to override the default 
file assignments for the various forms of the CYBIL common = deck 
library. For the CYBIL CC version the PROFILE variables should be 3: 


ccmn CYBCCMN in MADIFY format 
ccmnun owner of 'ccmnt 

ccscu: CYBCCMN in SCU format 
cescun owner of %ccscut 


For the CYBIL CI versions the PROFILE variabtes should be 3: 


icmn CYBICMN in MADIFY format 
teomnun owner of ticmnt 

icscu CYBICMN in SCU format 
icscun owner of ticscut 


Examples of GETCOMN Usage 


sesegetcomn 
REVERT. SCU VERSION OF CYSCCMN MADE LOCAL 
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sesegetcomn mad ci 
REVERT. MADIFY VERSION OF CYBICMN MADE LOCAL 


The first exampte shows GETCOMN acquiring the SCU version of 
CYBCCMN (both parameters take their defauits). The second example 
shows how to acquire the MADIFY version of CYSIEMN.: 


Note : please ensure that you RETURN the common deck library when 
you're finished with it. 
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3o14 SYSTEMX =_ GLOBALLY _CROSS_ REFERENCES A CYBIL_SYSTEM 


SYSTEMX (a MADIFY based CYBIL system cross reference facility) 
initially builds a data base containing a gfobal cross reference of 
al! CYBIL modules which reside on a specified set of MADIFY PL'*s. 
Then SYSTEMX can: 


1) query the data base for information pertaining to a CYBIL 
identifier or MADIFY deck name 


or 


2) output the entire data base to nine-tracks high-density (GE) 
tape(s) in a Format suitable for nicrofiche processing at 
Comsource Headquarters. 


The tape(s) made from running SYSTEMX with the fiche parameter 
specified shoutd be sent with a 'Microfiitn Work Request! (form no. 
AA5167) to Terry Larson ~ HOCOOH. The ‘Program ID* used on the 
*Microfilm Work Request? is ARH144. A "Master Charge No.* is also 
required to submit the "Microfilm Work Request!. Piease contact 
Kathy Beatty (482-2338) for information needed to acquire a "Master 
Charge No.!?. 


If building the data base, the default jobnode is batchn = and 
either the build or restart parameter must be given. If writing the 
data base to microfiche formatted tapes the default jobmode is 
batchn and the fiches sysname and vsn paraneters nust be given when 
beginning the jobs or just the fiche paraneter when restarting the 
job. If neither the builds restart or fiche parameter is givens 
then SYSTEMX assumes the query function where the default jobmode is 
focal and either the identifier or deck paraneter nust be given. 


The Build Function 
The parameters in effect are 3: 


product»spd 

build 

bases»sba 

packnamspn 

modules »md 

restart 
Phisph2sph3»sph4 
batch job parameters 


The permanent files teft in your catalog after phase4 completion 
are 3: 
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SYSXB1.-«SYSXBn where 1 ¢ N € 99 2auals the total number of 
MADIFY PL*s input during the build 

and 

SYSXRST SYSXPH1 SYSXDKS SYSXDR1 

SYSXDR2 SYSXSRT SYSXMST SYS XTMP 

SYSXTXT 


Of these permanent filess onty :. 


SYSXRST SYSXTXT SYSXMST SYS XTMP 
SYS XDR2 SYSXSRT SYSXDR1 


are required as Input to the query or fiche functions. 
The remaining permanent files : 
SYSXB1lL.SYSXBn SYSXPH1 SYSX9KS 


which were created during phasel of the build should be retained 
onty if a subset of your system was cross referenced via the product 
parameter and you will create another sub-system cross reference 
jater. Then retention of these files saves having to run phasel of 
the build over agains 


Note that ali of these files can be dumped to tape via the 
SES -DUMPPF procedure and then restored via the SES.LODADPF procedure. 
If these files are dumped from one catalog and restored into 
anothers then text fine two of file SYSX28ST must be changed to 
reflect the new user_number. 


Should the build require more than one processing session to 
complete (i.»@e,», restart(s))s then some oermnanent files feft by 
SYSTEMX in your catalog will begin with 'Z9* and others with *SYSX*. 
Please note that prior to beginning a SYSTEMX buitdds alt of the 
above mentioned filenames beginning with 'SYSX! must be purged from 
your catalog. 


Between restarts of the build functions users are strongly 
encouraged to backup on tape what has been produced up to that 
point. NOS could go down for the night or crash before SYSTEMX 
shuts itself downs in which case ait has been tost if previous 
output wasn't backed up to tape. To deternine which files to dump» 
simply Jist file SYSXRST and match file nanes from that tist to 
those in your cataloge Dump those files which natch and atso file 
SYSXRST. 


Phasel Description ; 
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Phasel creates a new set of MADIFY based PL's which are atmost 
identical to the original set of PL*s input. The difference is that 
comments now bracket the text of each deck: and contain information 
about the deck's origin. 


SYSTEMX must complete phasel and shut itself? down pending a 
restart during one processing sessions. If your system is targes 
then eight or more hours of wali clock tine should he availabie for 
processing when you begin this phases 


Phase2 Description 3? 


Phase2 creates and sorts the initia! set of files required by 
phase3. SYSTEMX must complete phase2 during one processing sessions 
though the wall clock time required is very short. 


Phase3 Description ;: 


Phase3 performs the bulk of the build process. Each CYBIL module 
in your system is builts CYBFORMed» compiled and fed into the glicba!l 
cross referencing logic. SYSTEMX defaults to perform this phase in 
100 module increments after which it voluntartiiy shuts itself down 
pending a subsequent restart. 


The 100 module default can be changed at’ any restart: occurring 
before phase3 completion to any number fron 1 to 999995 depending on 
the amount of processing time available. Please note that the tast 
figure selected remains in effect during subsequent phase3 restarts 
if anew figure isn't sefected at that tine via the modules 
parameter. 


SYSTEMX must complete phase3 or votuntarify terminate after. 
processing a preset number of modules. On 3 moderately toaded CYBER 
176, SYSTEMX can process about 30 modules per your of wall clock 
timee Of courses this can vary dramatically denending on the load. 


Phase4 Description : 


Phase4 performs the sorts and merges necessary to draw the global 
cross reference togethere SYSTEMX must conolete phase4 during one 
processing session. If your system is !arqes than eight or more 
hours of wall clock time should be available for orocessing when you 
begin this phase. 


Ihe_Eiche Eunction 
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The parameters in effect are : 


fiche 

entries 

sysname 

sysversion 

systevel 

vsn 

batch job parameters 


Output from the fiche function goes to nine-track, high-density 
tape or tapes containing one to many filese' The inportant thing you 
as the user need do is insure that the reels are externally numbered 
sequentially (i-ee. ones twos threes etc.} as they come off the 
drive. This sequencing function must continue through fiche 
restart(s) (i.e.» do not start sequencing hack at one if fiche 
restartis) are necessary). <Aisos mention to the ovoerators to "blank 
label a tape if necessary. 


If output of the data base to tase requires more than one 
processing session to complete (i.@.» fiche restartis))s then 
SYSTEMX will teave a permanent file in your catalog called SYSKFCH. 
If this file exists in your catalogs then vou are not finished yet. 
SYSTEMX defaults to process the data base in 152009 entry increments 
after which it voluntarily shuts itself down osending ai subsequent 
restart. 


The 15,2000 entry default can be changed at the beginning of the 
fiche job or at any subsequent fiche restart via the entries 
parameter to any number from 1 to 999995 desending on the amount of 
processing time available. Please note that the tast number 
selected remains in effect during subsequent. fiche restarts if a new 
number isn't selected at that time via the entries parameter, 


SYSTEMX must complete the fiche job or voluntarily terminate 
after processing a preset number of entries. In a moderatety loaded 
CYBER 176» SYSTEMX can process about 2000 entries oer hour of wall 
clock time. 


The microfiche themseives wil! thav2 two sections. The Source 
Deck section will consist of a sorted set of deck reports as 
described under the query function. The Global Crossref section 
will consist of a sorted set of identifier reports as described 
under the query function. 


Between fiche restarts users are strongly encouraged to copy file 
SYSXFCH to another indirect access file in their catalog. If NOS 
goes down for the night or crashes before SYSTEMX shuts itself down, 
then SYSTEMX can properly restart onty ff Fiie SYSXFCH can be 
restored to it's condition prior to the fiche restart which failed. 
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If a fiche restart fFailss simply restore file SYSXFCH to it's 
condition prior to that restart and attennot another fiche restart. 
Those tapes associated with the restart which fatited should be 
re—used beginning with the towest nunbered tape. If the fiche 
function fails during the initial processing sessions then purge 
file SYSXFCH and start over using the absolute towest numbered tape. 


Ihe. Query. Eunction 
The parameters in effect are 3: 


identifiers id 
outputso 

qual# 

deck 

batch job parameters 


Any user can query a SYSTEMX data base. Qniy aecopy of file 
SYSXRST must reside in that user's cataloge Line two of SYSXRST 
must contain the user_number of the catalog where the entire data 
base actually presides and the user must be validated to read those 
Files. 


Identifier Report 3 


For all CYBIL identifiers, except modules identifierss a complete 
system-wide cross reference report is returned. For a module 
Fdentifiers an unabridged compile file and standard CYBIt cross 
reference report is returned. 


Deck Report : 


Different CYBIL identifiers, each bearing the sane names can be a 
common occurrence within a CYBIL system. SYSTEMX aqualifies each 
identifier and each reference to that identifier by deck names 
base _names user names and deck _line number. 


The deck_line_number corresponds to the fine nunber as the phase3 
build received the deck. The comments otlaced around each source 
deck during phasel builds and potentially the CY3FORMing process» 
have altered the one-to-one relationshio to line numbers on the 
original source decks so SYSTEMX makes available a listing of each 
source deck as phase3 received it to restore that one-to-one 
relationship to the user. 


Parameters to SYSTEMX are 3? 
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identifier or id ; 


any valid CYBIL identifier is legal 
{id=ecimtinput_stack_manager). 


product or pd : 


unused : 


{optional) file name of a local or permanent file which 
contains a list of module deck names and/or moduje deck 
prefixes (if your system has such a convention) which 
specify to SYSTEMX a subset of your system you wish to 
obtain a global cross reference of. If the file name 
specified is both local and permanents the tocal one is 
useds The module deck names or prefixes can be delimited 
by spaces or EDL only and can occur on multiple text tines 
in this file. Please note that the File name tFULL’ has a 
special meaning and is not examineds but rather a complete 
system-wide cross reference is oroduced.» This parameter 
can be used in one of two wayse It can be specified 
during the initial call to SYSTEMX to begin the builds in 
which case the build parameter was useds or in conjunction 
with the restart parameter. If it is not specified at the 
initial build times the defauit is: to produce a complete 
system—wide cross reference. #hen used with the restart 
parameters, permanent files (SYSX31..5SYSX3n»e SYSXPH1s and 
SYSXDKS) must already exist. These files are created 
during phasel build. Att other’ "SYSX* files must be 
purged {ieees SYSXRST» SYSXDR1s SYSKXDR2s SYSXSRT» SYSXMST>» 
SYSXTMPs and SYSXTXT). (pdzprodfie) 


TBO 


output or o 3 


qual# : 


(optional) focal file name for output From aeSYSTEMX 
querye If the defauit (SYSXONIT) is useds it is rewound 
before outpute For any other file names the output is 
appended to the file. (oroutfile)d 


(optional) positive integer SYSTEMX uses to uniquely 
qualify an identifier which is defined more than once in 
your systeme When querying SYSTEMX about an identifier 
the first times skip the qual# oarameter and if the 
identifier is multipty defineds SYSTEMX witt return enough 
information so you can retry the query using the qual# 
parameter. (qual#=3) 
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deck ; 


build :; 


any valid MADIFY deck name is ftegal., (deck=cimism) 


key parameter tells SYSTEMX to bagin the buitd process 
from scratch. ({(buitd) 


bases or ba : 


packnam 


modules 


restart 


(optional) parameter default is to us2 the basename BASE? 
with the username of the current user. This parameter may 
be coded as a multi-valued fist of sublists. Each element 
of the vatue list is either a single nam2s in which case 
it is the name of a base in the current user's catalogs or 
the element is a sublist where the tast subelement in the 
sublist Is a username In whose catalfoa the bases referred 
to by the preceding subelements in that sublist may be 
found. Please note that a search order to MADIFY is 
implied when using this parameter, That order is from 
left to right. {ba=((sesllbdssesds (pscomplsbuiild)s 
Coslpisintl)»s (pascmnspcgsrcBspfesresin3))) 


or pn 3 

(optional) default for this oear’aneter is to use. the 
current user's permanent file device for the permanent 
Files SYSTEMX creates. For targe systemss enough mass 
storage may not be available on the user ts permanent file 
devices in which case two auxiliary devices can be 
specified fonly twode This oarameter’ is only used at 
initial build time or with a restart where the product 
parameter was also specified. This oaraneter may be coded 
as a multi-valued list of sublists. Each element of the 
value tist is a sublist where the fast subetement in the 
sublist is the device type of the oreceding packnames in 
that sublist. {(pnz={Cnvelsnve2sdil)) or 
pnz((nvelsdjl)»s (nve2sdil))) 


or md 3 
(optional) number of modules to process during phase3 
buiid before voluntarily shutting down pending a 
subsequent restart. The range can be from 1 to 99999, 
The default is 100 modules or the fast modules 
specification input by the user. (md2=49) 


a 
es 


this key tells SYSTEMX to restart the buiftd process. If 
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the product parameter is also specifieds the build process 
is restarted from the beginning of ohase23 otherwises the 
buitd process is continued fron wherever it teft off. 
When restart is specifieds the bases and packnam 
parameters are disregarded. (restart) 


Phl»s ph2s ph3s ph4 : 


fiche : 


entries 


sysname 


(optional) key telling SYSTEMX when to shut down pending a 
subsequent restart. phl corresoands to phasel and so one 
The default is ph&4 (which means do the whoie thing). 
Users are strongly encouraged to always use this parameter 
and step the build up one phase at atime. If a permanent 
file 'DAYFILE* doesn't appear in your catalog giving you 
the fast 100 lines of the Job's dayfile in the case of an 
aborts you can assume that the ltast build step attempted 
completed properly. 


this key telts SYSTEMX to begin writing the data base to 
microfiche formatted tape. If file SYSXFCH exists in your 
catalogs this key tells SYSTEMX to restart this process 
where it left of fs and the sysnanes sysversions systevel 
and vsn parameters are disregarded. (fiche) 


3 
{optional) number of entries to orocess during production 
of the fiche tape(s) before volutarifty shutting down 
pending a subsequent fiche restart. The range can be from 
1 to 99999, The defauitt is 152900 entries or the tast 
entries specification input by the user. One entry is 
defined as a singte 'deck report? or identifier report? as 
described under the query function. (entrtes=20,000) 


» 
. 


string parameter specifies the name of your system and can 
be any eight characters enclosed within single quotes. 
(sysname='NOS/VE*") 


coc 
SES 
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sysversion : 


{optional) string parameter specifles the version of 


system and can be any four characters enclosed 
single quotes. {sysversion='1,12') 


sysievel :. 


(optional) string parameter specifies the tevel of 


system and can be any five char’acter’s enclosed 
single quotes. (systevet='5!) 


vsn : 


your 
within 


your 
within 


string parameter enctosed within single quotes specifies 
any fegat NOS vsn to be used by SYSTEMK' when it issues a 
LABEL request for the tape required for fiche processing. 


batch job parameters ? 


This 


This 


these parameters are described in the section entitt 


ed SES 


PROCEDURES RUN AS BATCH JOBS. The default for the SYSTEMX 


build and fiche functions is to run in batchn modes 
they can be run in batchs defer or tocal modes as 


though 
well. 


The default for the SYSTEMX query function is to run in 
local modes though it can be run in batchs batchns or 
defer modes as well. The dayfilte parameter is used by 
SYSTEMX and if the job abortss the fast 100 tines of the 
dayfile are dumped to your catalog. Piease note that use 
of the jobtl par ameter is: strongly encouraged 


( jobt1=*77777(8)) to set the time timit to untiimited. 


Exampies of SYSTEMX Build Usage 


sesesystemx build baz((nosveptisosipisdspinlscybicmnsint2)) 
eo? pnz=((nvelsnve2sdi1)) phi jobt!277777(8). 


ee 


example shows the bhuitd process being tnitiated for the 
Advanced System. 


sesesystemx restart ph2 jobtt=#=77777(8) | 


example shows a restart of the same job to step through 


of the build. 


phase2 
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sesesystemx restart ph3 md240 jobti=77777(38) 
This exampie shows a restart of the same job to step through the 
first 40 modutes of processing in phase3 of the build. 

sesesystemx restart ph3 md=250 jobti=77777(8) 


This exampfie shows a restart of the sane job to step through the 
next 250 modules of processing in phase3 of the bulid. 


Note : When the first text line in File "SYSKRST* says #PH3? you 
know that phase3 is complete and the final ohase can be started, 
sesesystemx restart ph& jobtt=77777(8) 


This example shows a restart of the sane job to step through the 
final phase {(phase4) of the build process.: 


Exampties of SYSTEMX Fiche Usage 
sesesystemx fiche entries=20000 sysname="nos/vet es 
eet? sysversionz*1.12! systevel="5% yvsne#tp001" jobti=77777(8) 
This example shows the fiche process being initiated for the 
Advanced System. 
sesesystemx fiche entries240000 jobti=77777(8) 


This exampte shows a fiche restart of the same job to output the 
next 409000 entries in the data base to tape. 


Examples of SYSTEMX Query Usage 


sesesystemx idztree_node_contents qual#=s2 oztreefle 


This example shows a query of a multioty defined identifier 
tree_node_contents where the output is directed to file treefie. 


sesesystemx deck=z=listcmn qual#=2 
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This example shows a query of a multiply defined deck listcmn where 
output is defaulted to SYSXOUT. 


5-62 
COC —- SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
5.20 SOURCE TEXT MAINTENANCE 
5.215 SCOOP —- COMPARES MADIFY OR UPDATE SOIRCTE FILES 


TO AD A ND ND A A A A TA ND OED EON ATED SET AND ENE NES ENS A OA TOS ee NN HA ED SND ED EE EN TEND ED OO OD AN -A -EED ED AED  ED ENS D - Ae AE ED ee a a OD ee 


5015 3CO0P_=-_ COMPARES MADIFY OR UPDATE SOURCE _EILED 


SCOOP compares an 'old' file and a "new! files lists the changes 
that transform fold' to ‘'new's and generates source code utility 
corrections. Any MADIFY or UPDATE source Files navy be compared, 
Parameters to SCOOP are 3 


o or old : 
(optional) name of the old file which you: are comparing to 
the new file. The tines in this: file witl appear on the 
feft side of the tisting. If you don*t code _ this 
parameters, the procedure expects a default file name of 
LEFT. 


nor new ? 
(optional) name of the new file. If you: don't code this 
parameters SCGOP expects a default file name of RIGHT. 


{1 or tist : 
{optional) output Listing file generated by SCOOP. If you 
don't specify a value for this paraneter,s, it defaults to a 
file name of LISTING. 


s or short or nm or nomatch : 
(optional) key selecting short: lists changes only 
(additions and detetions). Otherwise, fines that are 
common to both files are also tlisted.’ errent restricts 
the number of changes listed. 


e or err or errs or errent ; 
(optional) number of changes to be tistede Coding a 
numeric value for this parameter restricts the number of 
changes to list. The default value is 999999. 


(optional) key selects SHORTs L=JUTOUT. 


pch : 
(optional) filename for punch output. This is the file 
containing MADIFY or UPDATE INSE2T and OELETE directives 
needed to change the old file to the new file. This file 
will not be generated uniess you specify a value for this 
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Parameter. 
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6.0 LIBRARY OR MULTI RECORD FILE MANAGEMENT USING LIBEDIT 


600 LIBRARY OR MULTI RECORD EILE_ MANAGEMENT. JIING LIBEDIT 


SES supplies a comprehensive set of procedures to manage multi 
record filess using the NGS LIBEDIT satitity as abasis. It's 
assumed that youtfre fairly familiar with the ideas of muiti record 
File and LIBEDIT. The terminology that SES orocedure descriptions 
of library management use are as follows 3. 


LIBRARY A collection of records in ae File. Ali SES tibrary 
management procedures use an f parameter to refer to a 
Librarye 


MEMBER A single record in a library files or a file containing a 
member which is added to or replaced on a librarye All SES 
library management procedures use an m parameter to refer 
to MEMBER(S). 


GROUP ‘a collection of member(s) that occupy one record per member 
on the file. 
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SummaryOf_ Library Management Procedures 


GETMEM(S) 


REPMEM(S) 


REPULIB 


COLLECT 


CATLIB 


LISTMEM 


SORTMEM 


SRTULIB 


WIPEMEN 


WIPULIB 


LIBEDIT 


GET MEMberS gout of a jiibrary gat9 a group file. The 
members appear one per logical record... 


REPlace or add MEMberS on a4 tibrary. You also use 
REPMEM({(S) in a Special way to creat2® a brand new tibrary 
from scratch. 


REPiace or add members on a User Library. 
coliect a group of members onto a group file. 


CATalog a LIBrary to display the names and the types of 
members in the fibrarys in short Form output. 


LIST MEMbers. LISTMEM generates a catalog of ali the 
members on ae tlibrarys and optionatty prints every TEXT 
member from the library. 


SORT MEMbers in a library. The tihbrary is arranged so 
that ali members of the sane type appear together. 
Within each member types the nenhbers are sorted into 
alphabetical order. 


SoRT members in a User LIBrary.’ 
WIPE (delete) MEMbers from a library.’ 
WIPe (detete) members from a User’ LIBrary. 


use the LIBEDIT utility directiy. 
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Pacameter Naming. Convention for Library Mayagement 


This section introduces the parameter ranting canvention§ thats 
common to most of the procedures in the library management system. 


lor b name of Library on which the operations are to be 
per formede 


m stands for Member(s). 


g or group name of file upon which a GROUP of members are 
accumulated when adding or raplacing members on a 
library» or when members are extracted from a library. 
A group file contains one menber oer Vogical record. 


nioor nab name of a New Library or New Bases used in those 
procedures that perform operations that permanentty 
alter a 4ibrarys requiring that anew tibrary be 
created. An explanation of the method used to update 
aiibrary is contained in a subsequent section. 
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PROFILE Variables_for Library Management 


The variables described below may be dectared in: your PROFILE in 
order to establish default information for the parameters of the 
library management procedures. 


¥ib name of library where members are to be found or replaced. 
libown user name in whose catalog the tibr’ary fs to be found. 


newlib name of new library for thos® orocedures which update a 
fibrarys thereby creating a new ote. The defauit name for 
newlib is the same name as the old fttbrary. 


group used by all procedures to designate a group files or a file 
containing one module per togical record. The defauit name 
for group Is group. 


sestmpi used by ali of the procedur2s that update tibraries to 
specify the temporary iibrary file during the update 
processe The default name for this file is sestmpli. 


fokmode determines the interlocking action when undating a tibrary. 
The tokmode variable may be set to "LOCK" (tock by default 
untess the noltlock perameter is coded on the procedure) or 
*'NOLOCK*® {no tock by default unless the fock parameter iis 
coded on the procedure). 


intriok used by atl of the procedures that uodate libraries or 
bases to specify the interlock file to be used during the 
update process. The default name for the interlock file is 
intriok. 


nx used by all of the procedures that uodate User LIBrartes to 
specify whether a cross reference of entry points is to be 
included in the tlibrary. If nx ts set to any non-null 
values, the entry point cross reference is not included by 
defauits otherwise it is. 
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6-0 LIBRARY OR MULTI RECORD FILE MANAGEMENT USING LIBEDIT 


Library Updating Process 


Some of the ftibrary management procedures ohysicaliy aiter a 
library», requiring that a new tibrary be created. The process is 
common to all such proceduress and is as follows 3 


If you code both the 1! and nfo parameterss new fibrary is created 
simply by performing the required operationras on the old tibrarys and 
writing the newly created library onto the File specified by the ni 
parameter. 


If you code oniy the 4 parameters update takes place in two 
stagese The updating operation is perforned and the new tIibrary 
written to a file called sestmp! (SES TeMPorary Library). sestmp! 
is then physically copied back over the file specified by the 1 
parameters and finality sestmpl is purged. 


Note that if the file specified by the nf’ (or # if nb is omitted) 
does not aliready exists a DIRECT access READ mode file its DEFINEd 
for the library (thiss of courses can onty be done if the owner of 
the library is the current user). 


Note that if anything goes wrong during an uodating runs the 
original tlibrary is always feft intacts and only the new library or 
sestmp!i is potentiaily incorrect. This maans that you can recover 
by purging the new tibrary or sestmpl and starting the run again. 
If something goes wrong before the tlibrary appears on sestmplt>, 
original tibrary is intacts and sestmp!: nay be ourgeds whereas if 
something goes wrong after the new library is on sestmpts that is» 
during the "rewrite”™ phase of the updates it is sestmp! that is 
safes and the old ‘fibrary that Is wronge [1 this cases yow may use 
the REWRITE procedure to do the rewrite agains or alternativelys you 
may just purge the old library and then change the name of sestap! 
to be the tibrary name. 
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Interlock Process for Updating a Library 


When updating a library you can intertock: the undate so that only 
one user at atime can update the library. Those procedures that 
update a tibrary are set up so that if the tibrary to be updated is 
in another user's catalogs the tibrary is interlocked by default. 
You can override default actions by defining a tokmode variable in 
your profiles, or by coding a flock or notock: key on the procedures as 
shown in the diagram on the next page. 


Interlocking of a tibrary is done via an intertock file. Such a 
file must be a QIRECT access file in the sape yserts catalog as the 
dibcary being uedated.» Naturally the interiock file must be a 
PUBLICs WRITE MODE file if other users are tikety to be using it. 
The default name used by the SES source code maintenance and tibrary 
management procedures for the tock file is Intertok. You can have 
an interlock file of any name by defining the tntriok profile 
variables or by coding a file name as a value for the flock parameter. 
on the appropriate procedures. 
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$ ee eee ee $e em ee en a a nn en eee -——+ 
i Coded On 3 cok 
+ Procedure 3 Action Caken ; 
H lock ; fibrary or base is locked regardiess of contents of } 
H : lokmode profile variable or ed Cont see. 
fp we oe oe 1 ee 2 eee ee oe ee > AD EP SE EE ERD AED SER AED END AED SED ND AS ln eT ENS AT OY me SAR SO CEU AON ATO ND SA SEND ES AA OE A NN I EOD ED DED A HED AD ED EL IO NE OY SU 
nolock: : Jibrary or base is nat locked regardless of San tents 

3 


; of tokmode profile variable or eer Sonat trons 
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+ 


Nothing i: Coded in Profile : “Ast ton Taken 


se ea ee te se ys er fe ne nem ca ne A AR eat me en tl re te SO SE AS MR A i he 
\ tokmodes*LOCK* } JtYibrary or base is locked 
s untiess overridden by notock 
: parameter on procedure. 
\ bokmode="*NOLOCK* : ftibrary or base [5s pot tocked 
; untess overridden by fock 
$ parameter on procedure. 
+ 
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Nothing i: Or Library ; Action Iaken 


$ Current User { library or base is not 
: locked untess the tokmode 
$ profite variable is set 
+ to *'LOAeCK® or the tock 
+ Oarameter is coded on the 
$ procedures 
ee ee ee oe 
Another User { ttbr‘’ary or base jis tocked 
 uniass the fokmode 
; orofitea wariable is set 
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+ parameter fs coded on the 
: procedure 
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Gel GETMEM_ OR GETMEMS =_EXTRACT MEMBER(S) ERIM LIBRARY 


GETMEM(S) is intended for extracting any umber of members from a 
library onto a group files with one nenber per togical record. 
Parameters to GETMEM(S) are : 


moor ali 3 

if you code the all keywords GETMEM(S) extracts ALL 
members from the Jibrary specified by the I parameter. 
Otherwises you code the m parameter as a fist of name(s) 
of Member(s) to be extracted. The fist of member(s) must 
all be of the same type (as specified by parameter 6). 
Ranges of member names nay also be codeds as shown in the 
examples at the end of this description... 


g or group ? 
Coptional) name of group file ts receive the member(s) 
extracted from the fibrary. TIF you dontt code the g 
parameters GETMEM{S) uses the value of profile variable 
group» and if therets no such variable defineds uses the 
name group for the group file. 


lor b : 
(optional) name of Library from which the member(s) are to 
extracted. If you dontt code the f parameters GETMEM{(S) 
either uses the value of profile variable tibs or iif 
that's undefineds GETMEM(S) uses the rame fib for the name 
of the tibrary. 


un 3 
(optional) User Name in whose catalog the library 
specified by 4 is to be founds if it tsn't in the catatog 
of the current users If you dontt code the un parameters 
GETMEM(S) uses the value of profile variable tibowns and 
if there*s no such variable defineds the GETMEM(S) uses 
the user name of the current user. 


status or sts : 
these foptional) keys can be used For those cases where 
GETMEM(S) is being used as a buifding biock of more 
sophisticated procedures or jobs» The status key causes 
the GETMEM(S) procedure to set the NOS job control 
register EFG to the value zero If SETMEM(S) successfully 
completeds and non zero if anything went wrong during the 
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run of GETMEM(S). If status is not specifieds the 
procedure will EXIT if an error occurs, 


text or opi or opic or opid or rel or abs or ov4 or pp or ppu or 

ulib or cap or proc : : 
these (optional) keys specifies the type of the members to 
be removed from the tibrary. IF you dontt code any of 
these keys» GETMEM(S) assumes the members are of type 
TEXT.» <A description of the meaninas of these rather funny 
looking keys can be found in the NOS Reference Manual 
under the description of LIBEDIT.: 


Examples of GETMEM{(S) Jsage 


sesegetmem format i=prociib unzir77 text 
REVERT. END GETMEM GROUP <- PROCLIB: 


The example uses GETMEM to get one text nenber calied format from 
a library called proctib in the catatog of user ir7?. 


sesegetmem (txtcodestxtformstxthead) binary tzprgtiib un=znav73 ovi 
REVERT. END GETMEM BINARY <= PRGLIB 


This exampite extracts a group of ovi type2 records from a tibrary 
calted prgiib in the catalog of user mv73 and olaces them on a group 
file called binary. 


sesegetmem (computeepiscans ciilev..ciiord) txdbugtib rel 
REVERT. END GETMEM GROUP <= DBUGLIB 


This exampte ilttustrates how ranges may be coded for a parameter. 
The example extracts ali rel members comout through piscan 
incltusives and alt members ciilev through citord inclusives from a 
fibrary called dbuglibs and piaces the extracted members on the file 
called group. 
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6e2 REPMEM_OR_REPMEMS =_ADD_OR REPLACE MEMBER(S) _DN_LIBRARY 


REPMEM and REPMEMS are synonyms for a procedure to add new 
member(s) tos or replace member(s) on a library... Note : to add or 
replace members on a User LIiBrarys for use by the CYBER loaders use 
the REPULIB procedure described betow. Parameters to REPMEM{S) 
are 3: 


moor mem or mems or member or members : 
(optional) tist of Member{s) to 52 added to or reptaced on 
the library. If you don't code the m parameters REPMEM(S) 
assumes that all the member(s) to be added or replaced are 
already on a file specified by the g parameter. 


g or group ?. 
(optional) name of a group Fite on which member(s) are 


accumulated as one member per tlogical record. If you 
dontt code the g parameters 2EOMEM{S) uses the value of 
profile variable group. If therets no such profile 


variable defineds REPMEM(S) uses filename group as the 
group file. 


ior b:3 
(optional) name of Library on which the member(s) are to 
be added or replaced. If you don*t code the 1! parameter, 
REPMEM(S) uses the value of profile variable tYWib as the 
name of the library. If therets no such profile variabie 
defineds REPMEM(S) uses a library name of Vib. 


nioor nb : 
{optional) name of New Library to be created when 
REPMEM(S) has completed its run. If you dontt code the nf 
parameters, REPMEM(S) uses the vatue of oprofile variabie 
newlibs and if there's no such orofite variabie defineds 
REPMEM(S) writes the new library xver the file specified 
by the ! parameter. 


un 3 
(optional) User Name in whose catatog the tibrary 
specified by I/nt is to be founds tf U7nl' is not in the 
catalog of the current user. If you dontt code the un 
parameters REPMEM(S) uses the value of oprofile variabie 
fibown as the user name from whose catalog the library is 
to be obtaineds and if there's no such variable defined, 
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REPMEM(S) uses the current user's catalog. 


flock or nolock : 

these (optional) parameters deternine whether the base 
update process is interlocked against simultaneous updates} 
coding a filename for the fock oarameter determines the 
name of the interlock file. [nterlocking is the default 
action when the base being updated is in another user's 
catalog. If you dontt code either of the tock or notock 
keyss interlocking is controlled by the tlokmode profite 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nofock parameters. If 
you don*t code a filename for the tock parameter, the 
contents of profile variabie intritok is used as the 
interlock filenames if there's no such orofile variables 
the name intriok is used as the tock filename. The 
intertock file must be in the sane catalog as the base 
being updated. If the interfock fite cannot be founds the 
procedure aborts. 


batch job parameters : 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH J03S". The default for this 
procedure is to run in tocal modes but it can be run in 
batch mode. The dayfite parameter is not used by this 
procedure. 


rep or add or addrep or repadd : 
these (optional) keys specify whether youtre adding and 
replacings or just replacing. If you'tre only replacing 
member(s)» you can code the rep kay. If you omit this key 
altogethers REPMEM{S) assumes that you're adding and 
replacing member(s) and = so issues the appropriate 
directives to LIBEDIT to perform that function. 


dir or bulf'd or nodir or nobuild : 

these (optional) keys specify whether a directory is to be 
placed at the end of the library when REPMEMIS) finishes 
its rune Coding the dir or buifd ootions specifies that 
you want a directory record to b2 added to the fibrary. 
If you code the nodir or nobuild optionss or if you dontt 
code any of these keys» REPMEM{(S) doesnit add a directory 
but if a directory already exists it is uodated. 
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msg or nomsg : . 
these (optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFIRMATIVE MESSAGES 
FROM SES PROCEDURES", 


Exampies of REPMEM(S) Jsage. 


seserepmem (firsts seconds third) tzberktibs buitd 
FIRST => GROUP 

SECOND => GROUP 

THIRD -—> GROUP 

REPLACING/ADDING MEMBERS ON BERKLIB. 

LIBRARY NOW ON SESTMPL 

NEW LIBRARY NOW ON BERKLIB 

BERKLIB PURGED 

REVERT. END REPMEM GROUP => BERKLTB 


HEUER E HN H 


This example illustrates REPMEM used to collect three members 
onto a group files, and then place the contents of the group file on 
a iibrary called berkiib. The exampie shows sone of the informative 
messages that appear during a REPMEM run. 


Creating. a New Library with REPMEM(S) 


seserepmem lzdummys nizproclibs g=newproc buitd 
* CREATING NEW LIBRARY PROCLIB 
REVERT. END REPMEM NEWPROC => PROCLIB 


This example illustrates how to build a new ttbrary. The 
parameter is coded as some “dummy™ name that doesn't exist. The new 
members to be added are on a group file called newproc. The new 
library is createds anda directory is added because of the build 
Keys 
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63 REPULTO.=_ADD_OR REPLACE MEMBER(S) ON JER LIBRARY 


REPULIB is a special version of REPMEM(S) to add or replace 
member(s) on a User LIiBrary.e LIBEDIT (the basis for these library 
Management procedures) can't handie user tJlibraries directtys so 
REPULIB uses the LIBEDIT and LIBGEN utilities to perform the process 
correctly. Parameters to REPULIB are 3; 


m or mem or mems or member or members : 
{optional) tist of Member(s) to be added to or reptaced on 
the tibrary. If you don't code the m varameters, REPULIB 
assumes that all the member(s) to be added or replaced are 
already on a file specified by the q oaraneter. 


g or group 3 
(optional) name of aie group file on which member(s) are 


accumulated as one member per togical record. If you 
don't code the gq parameter» REPULIR uses the vatue of 
profile variable group. If there's no such profile 
variable defined, REPULIB uses filanamne group as the group 
file. 


lor b 3 
{optionalt) name of Library on which the nember(s) are to 
be added or replaced. If you dor'’t code the ! parameters 
REPULIB uses the value of profite vartable tib as the name 
of the tibrary. If there's no such profijie variable 
defineds REPULIB uses a Jibrary nane of tib. 


nioor nb : 
(optional) name of New Library to he created when REPULIB 
has completed its rune If you dontt code the nl 
parameter, REPULIB uses the value of oprofile variable 
newlibs, and if there's no such orofile variable defineds 
REPULIB writes the new tibrary over the file specified by 
the | parameter. 


un 3 
(optional) User Name in whose catalog the tibrary 
specified by i/ni is to be Founds if I/nti is not itn the 
catalog of the current user. If you don*t code the un 
parameters, REPULIB uses the value of profile variable 
fibown as the user name from whose catalog the library is 
to be obtaineds and if there's no such variable defineds 
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REPULIB uses the current user's catalog. 


fock or nolock ;: 


these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the tock ovaraneter determines the 
name of the interlock file. Interlocking is the default 
action when the base being updated is in another user's 
catalog. If you don*t code either of the tock or nolock 
keys» interlocking is controtied by the ftokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the fock and notock parameters. If 
you don't code a filename for the fock parameters, the 
contents of profile variable intrtok is used as the 
interiock filename; if there's no such owrofile variables 
the name intriok is used as the tock filename. The 
interlock file must be in the sane catatoq as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


batch job parameters : 


These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH JO8S". The default for this 
procedure is to run in tocal mod2,s but it can be run in 
batch mode. The dayfite parameter is not used by this 
procedure. 


rep or add or addrep or repadd ; 


AX 


this (optional) key specifies whether youtre adding and 
replacings or just replacing. If you're only repiacing 
member(s) you can code the rep key.» If you omit this key 
altogether» REPULIB assumes that you're adding and 
repiacing member(s) and so issues. the appropriate 
directives to LIBEDIT to perforn that Function. 


this (optional) key indicates that when REPULIB performs 
the LIBGEN portion of its jobs that LIBGEN shouid not 
buiid a cross reference of entry ooints in the ULIB 
record. You can set your own defautt for this parameter 
by defining the nx variable in your orofite (any non-null 
value causes the cross reference to not be built). Refer 
to the LIBGEN documentation in the NOS reference manual. 
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mSg or nomsg ;: 
these (optional) keys contro! the generation of 
informative messages by this procedure and are fully 
described in the section entitiad "INFIRMATIVE MESSAGES 
FROM SES PROCEDURES". 
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604 COLLECT ~_ COLLECT MEMBER(S) TO BUILD_A_G20U2_EILE 


COLLECT is used in conjunction with tibrary nanagement procedures 
such as REPMEM(S). COLLECT is used to accunulate members onto a 
group file for subsequent processing by REOMEM(S)s LIBEDIT and so 
One COLLECT can also be used in conjunction with source text 
maintenance procedures, to collect text moduless adding headers and 
COMMON fines if required. Parameters to COLLECT are : 


moor mem or mems or member or members : 
(optional) list of Members to be accumulated onto the 
group file. Note : if the File specified by the a 
parameter is a muiti record files CILLECT does: gather ail 
records in the file. This capability is gngt available 
with the c andr parameters as It is not: truly applicable 
in those caseSe 


ec or com or optic : 
(optional) tist of COMmon modules to be accumulated onto 
the group file. COLLECT assumes that such modules are 
straight text filess and so COLLECT olaces the module name 
and COMMON fine at the start of the module. 


rf or reg or opi 3: 
(optional) tist of REGular modules to be accumulated onto 
the group file. COLLECT assumes that such modutes = are 
straight text filess and so COLLECT olaces the module name 
at the start of the moduie. 


g or group : 
(optional) name of group file onto which the member(s) or 
module(s) are to be accumulated. If you don't code the g 
parameters COLLECT uses the value of profile variable 
group. If there's no such vartiabie defined in your 
profiles COLLECT uses the filenane group. 


msg or nomsg ; 
these (optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Exampie of COLLECT Usage 


sesecolfect (docodesdostatseatupseltseifs equal) gzcoders 
DOCODE -> CODERS 

DOSTAT => CODERS 

EATUP => CODERS 

ELSEIF -> CODERS 

EQUAL => CODERS 

REVERT. END COLLECT CODERS 


+t +e tH # 


This example of COLLECT illustrates how it is used to accumulate 
a bunch of records onto a group file. 
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605 CATLIB8B_~_ PRODUCE LIST _OF_MEMBERS_IN_A_LIBRARY 


CATLIB is used to display a fist of the members in a ttibrary. 
CATLIB outputs the members list in a condensed fornats four members 
per lines showing only the member names and their tyne, Parameters 
to CATLIB are 3: 


1! or b 3: 
(optional) name of Library which is to have its member 
names displayed. If you don't code the | =xparameter, 
CATLIB uses the value of profile variabie lib as the name 
of the tibrary,s, and if there's no such variable defined,» 
CATLIB uses a File name of fib. 


un 3 
(optional) User Name in whose catalog the tibrary 
specified by the § parameter is to be Found. If you dontt 
code the un parameters CATLIB8 uses the value of profile 
variable fibown as the user names and if there's no such 
variable defineds CATLIB uses the current user's catalog. 
o 3 


{optional) name of file to receive the Outout from CATLIB. 
If you dontt code the o paraneters CATLIB places the 
member fist on file output. 


short or tong : 
these (optional) keys determine the format of the output 
from CATLIB. If you omit this oaraneter or code the short 
key» CATLIB produces its output in the Form shown in the 
exampfe below. If you code the tong keys CATLIB produces 
its output in the same format as the NOS utility CATALOG. 
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Exampitie of CATLIB Usage 
sesecatilib becsiolib un=mv69 
CSIGLI8B..ULIB ASSTOIA. REL AbB4TOI Ae REL CATLIST.»eREL 
CNVCASE*e aREL CPYAceeeeREL C59TOTA. REL TATOA592eREL 
TATOA64eeREL IATON5S 9. eREL TATON64. REL IDEBUG.) oe eREL 
IDEBUGI.-REL IKMISCeeeREL ISCLMSG.LREL ISOLSYS.-REL 
ISYSTIM. REL MCOMPe. ee eREL MCS cece ee REL MCSCNVseeREL 
MEXPRe eeeREL MGET oe ee e REL MGETCSP..REL MGETKCS.-REL 
MGETSYMeeREL MGETTOK. REL MLOCFIL..REL MMSGeeeeeREL 
MPDTPVT..REL MPLIST »2eeREL MPUT ose ee REL MSTREAM.eREL 
MTOKCNVeeREL NOOTOI As’ eREL NO4TOTAe REL PKUNPK ee eREL 
ZIATOXC. REL ZXCTOIA.eREL CSIOLIRB..93PLD 
REVERT. END CATLI8 CSIOLIB 


This example shows CATLIB output for a tibrary csiolib in the 
catalog of user mv69. The member types: are as defined in the NOS 
reference manual section on LIBEDIT. 
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6.6 LISTMEM =_LIST_ CONTENTS _OF_ LIBRARY 


LISTMEM performs two main functions to show you what's in a 
librarys and to get a printout of the TEXT nembers in the library if 
necessaryse LISTMEM first generates a nornal CATALIG which shows the 
names of ali the members in the ftibrary. Lastivs LISTMEM generates 
a printout of ail TEXT members in the tibrary - vou can suppress 
this if you only want the catalog without the whole tibrary's 
contents. Parameters to LISTMEM are 3 


jf or b: 
{optional) name of Library to be orocessed. If you dontt 
code the b parameter» LISTMEM uses the value of profile 
variable fib as the library names and if there's no such 
variable defineds the LISTMEM uses the default name tib. 


03 
(optional) name of fite to receive the Qutoput From LISTMEM 
piaces the output on some unique file name that it 
generates. The output doesn't default to file output 
becauses if you're running LISTMEM interactivelys you 
probably don't want the rather’ voluminous output on the 
screens 

un 3 


(optional) User Name in whose catalog the library 
specified by f# is to be found. If you dontt code the un 
parameters LISTMEM uses the value2 of the vatue of profile 
variable fibowns, and if there isr*t such variabte defined» 
LISTMEM uses the user name of the current user. 


batch job parameters :} 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH J938S". The default for this 
procedure is to run in batch modes but it’ can be run in 
local mode. The dayfile paraneter is not used by this 
procedure. 


print : 
this (optional) parameter indicates how the output of 
LISTMEM is to be printed. For the print parameter you may 
code any of the parameters to orncedure PRINT. If you 
don't code the print parameter at alls LISTMEM prints one 
(1) copy of the output on the ASCII printer. 
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, 


short 3. 
if you code this (optional) key» LISTMEM only generates 
the catalog outputs and suppresses the isting of ali the 
TEXT members. 


Examples of LISTMEM Usage 


seselistmem print=c=3 short 
12234256. SUBMIT COMPLETE. JQOBNAME IS ACULARS 
REVERT. JOB LISTMEM SUBMITTED 


This example shows LISTMEM used to process a fibtrarys, whatever 
name is the value of fib. Three copies of the short tist (catalog 
oniy) are being produced. LISTMEM is being run in batchs rather 
than interactively. 


seselistmem b=proclib ozprocs print=s(cz2shs*fatest/prociibt) 
18212200. SUBMIT COMPLETE. JOGBNAME IS ANAPABS 
REVERT. JOB LISTMEM SUBMITTED 


This exampie shows LISTMEM being run in batch to produce two full 
printouts of the catalog and ail the TEXT mnembers in the library 
prociib. The titie on the listing is "latest oroclib?. 
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6e7 SORIMEM -_ SORT LIBRARY INTO _ ALPHABETICAL ORDER 


SORTMEM rearranges a library such that all the nembers of a given 
type appear in the tibrary togethers and within each types the 
members are sorted into aiphabetical order’.’ Note : to sort a User 
LIBrarys for use by the CYBER jioaders use the SRTULIB procedure 
described below. Parameters to SORTMEM are :- 


1 or b 3 
(optional) name of Library to be sorted.! If you dontt 
code the t parameters SGORTMEM uses the value of profite 
variable tib. If therets no such orofile variable 


defined» SORTMEM uses the name 9b. 


nioor nb : 
(optional) name of New Library to be created at the end of 
the SGRTMEM rune If you don*t code the nl parameters, 
SGRTMEM uses the vaiue of orofile vartable newlib. If 
therets no such vorofile variable defineds SORTMEM writes 
the new tibrary on the file specified by the ! parameter. 


un 3 
(optional) User Name in whose catalog the library 
specified by t/nt is to be founds FF I/nt is not in the 
catalog of the current user. If you dontt code the un 
parameters, SORTMEM uses the vatue of profile variable 
{ibown as the user name from whose catalog the library is 
to be obtaineds and if there's: no such variable defineds 
SGORTMEM uses the current user's catalog. 


(optional) name of file to receive the Qutput of the 
programs used to run SORTMEM. If you dontt code the o 
parameters SORTMEM sets 0805 or no output. This is 
usualiy the desirabte defaults» since the sort process 
generates ltarge volumes of output,’ 


edtsort ;: 
(optional) pair of filenames representing the input and 
output files of the EDT text editor. You can use edtsort 
to EDIT the SORT output to imoose your own ordering on the 
members in the tibrarye 
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lock or nolock ;: 

these (optional) parameters deternine whether the base 
update process is intertocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. [Unterlocking is the default 
action when the base being updated is in another user's 
catalog. If you dontt code either of the Yock or notock 
keys» interlocking is controlled by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variabie and the tock and nolock parameters. If 
you don't code a filename for the tock: parameters, the 
contents of profiie variabie intrtok is used as the 
interlock filename; if there's no such orofile variables 
the name intrliok is used as the tock filename. The 
interlock file must be in the sane cataloq as the hbase 
being updated. If the interlock File cannot be founds the 
procedure aborts. 


batch job parameters ; 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH J985". The default for this 
procedure is to run in tocal modes but it can be run in 
batch mode. The dayfile paraneter is not used by this 
procedure. 


nodir or nobuild or dir or build : 

these (optional) keys indicate whether a directory is to 
be placed at the end of the tibrary when SORTMEM has 
finished its run. If you code the nodir or nobuild key» 
SORTMEM doesn't place a directory In the library. If you 
code the dir or buitd keys SORTMEY does place a directory 
in the tibrary. If you don?t code any of these keys» 
SORTMEM does a builds that iss a directory is created for 
the sorted tibrary. 


msg or nomsg : 
these {optionat) keys control the generation of 
informative messages by this orocedure and are “(fully 
described in the section entitted = "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*, 
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Exampies of SORTMEM Usage 


sesesortmem tzprociib batchn 
17.52.00. SUBMIT COMPLETE. JOBNAME IS ADXISBEN: 
REVERT. JOB SORTMEM SUBMITTED 


This example illustrates SORTMEM being run as a batch job by 
coding the batch key. SQORTMEM is being used to sort the file 
proctib into order. 


sesesortmem izberklib fock build 
LOCKING BERKLI8B VIA INTRLOK 
BERKLIB LOCKED 

GENERATING MEMBER LISTS FOR BERKLTIB 
SORTING MEMBER LISTS 

EXTRACTING MEMBERS FROM BERKLIB 
SORTING BERKLIB ONTO SESTMPL 
NEW LIBRARY ON SESTMPL 

NEW LIBRARY NOW ON BERKLIB 
SESTMPL PURGED 

BERKLIB UNLOCKED 

REVERT. END SORTMEM BERKLIB 


HHH HH HHH 


This example illustrates SORTMEM run white you waits at the 
terminal. The example shows the iinfornative nessages output by 
SORTMEM during its run. 
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608 SRIULIAR_- SORT USER LIBRARY INTO ALPHABETICAL _JRDER 


SRTULIB is a special version of SORTMEM for sorting a User 
LIBrary into alphabetical order. LIBE7IT (the basis for these 
library management procedures) can't handie user libraries directly, 
so SRTULIB uses the LIBEDIT and LIBGEN utilities to perform the 
process correctiy.» Parameters to SRTULIB are 3. 


{or b 3 
{optional) name of Library to be sorted.: If you don*t 
code the & parameters SRTULIB uses the value of profile 
variable tlib. If therets no such profile variable 
defineds SRTULIB uses the name ttb. 


nloor nb 3: 
{optionati) name of New Library to be created at the end of 
the SRTULIB run. If you don*t code the nt parameter, 
SRTULIB uses the value of profile variable newlib. If 
therets no such profile variabie defineds SRTULIB writes 
the new tlibrary on the file specified by the 4 parameter. 


un 3 
(optional) User Name in whose catalog the fjibrary 
specified by t/nt is to be founds if I7nt is not in the 
catalog of the current user. If you dontt code the un 
parameter, SRTULIB uses the value of profile variable 
fibown as the user name from whose catatog the fibrary is 
to be obtaineds and if there's no such variable defined, 
SRTULIB uses the current user's catalog. 


{ootional) name of file to receive the Qutput of the 
programs used to run SRTULIB. If you don*t code the o 
parameters SRTULIB sets 020» or 19 sutput. This is 
usually the desirable defauits since the sort process 
generates targe volumes of output. 


edtsort : 
(optional) pair of filenames representing the input and 
output files of the EDT text editor. You can use edtsort 
to EDIT the SORT output to impose your own ordering on the 
members in the tibrary. 
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lock or nolock 3 


these (optional) parameters determine whether the base 
update process ts interlocked against simuittaneous updates; 
coding a filename for the tock oarameter determines the 
name of the interlock file. Intertocking is the defayit 
action when the base being updated is in another user's 
catalog. If you don*t code either of the fock or nolock 
keys» interlocking is controlied by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nolock: parameters. If 
you don't code a fiiename for the fock: parameters, the 
contents of profile variable intrlok is used as the 
interlock filenames if there*s no such orofile variables 
the name intriok is used as the tock filename. The 
interlock file gust be in the sane catalog as the base 
being updated. If the intertock file cannot be founds the 
procedure aborts. 


batch job parameters ; 


nx 


These parameters are described in the section entitled 
"SES PROCEDURES RUN AS BATCH J98S". The default for this 
procedure is to run in focal modes but it can be run in 
batch mode. The dayfite parameter is not used by this 
procedure. 


this (optional) key indicates that when SRTULIB performs 
the LIBGEN portion of its jobs that LIBGEN should not 
bulid across reference of entry ooints in the ULIB 
record. You can set your own dafault For this parameter 
by defining the nx variable in your oprofite (any non-nuil 
value causes the cross reference to jot be built). Refer 
to the LIBGEN documentation in the NTIS reference manual. 


msg or nomsg : 


these (optional) keys control the generation of 
informative messages by this orocedur’e and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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669 WIPEMEM = DELETE MEMBER(S) EFRON LIBRARY’ 


WIPEMEM is intended as a means of deleting nember(s) from a 
librarye Note : to delete member(s) fron a Jser LiBrarys for use 
by the CYBER loaders use the WIPULIB procedure described below, 
Parameters to WIPEMEM are : : 


lor b?: 
(optional) name of Library from which member(s) are to be 
deleted. If you don*t code the ! parameters WIPEMEM uses 
the value of oprofite variable tib as the name of the 
library. If there*s no such profile variable defined» 
WIPEMEM uses the name tib as the name of the library. 


nioor nb ?: 
(optional) name of New Library to be created at the end of 
the WIPEMEM run. If you don*t code the nat parameter, 
WIPEMEM uses the value of profile vartabie newtib as the 
name of the new tibrary. If therets no such profile 
variable defineds WIPEMEM places the new library back over 
the otd library specified by the f oar‘ameter. 


un 3 
(optional) User Name in whose catatog the library 
specified by f/nt is to be founds if f/nt is not in the 
catalog of the current user. If vou don't code the wun 
parameter, WIPEMEM uses the vaiue of profile variable 
fibown as the user name from whose catalog the fibrary is 
to be obtaineds and if there*s no such variable defined, 
WIPEMEM uses the current user's catalog. 


text : . 
(optional) tist of TEXT member(s) to be deleted. 


opic or com or c 3 
(optional) list of OPLC Common menbert{s) or COMmon modules 
to be deleted. 


opt or reg or r 3 
(optional) tist of OPL or REGular’ nenberts) to be deleted. 


rel. : 
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ovi 3 


abs 3 


ppu-: 


«eo 


cap 


proc : 


{optional) list of RELocatable binary member(s) to be 
deleted. 


(optional) ftist of OVerLay type nember(s} to be deleted. 


(optional) tist of ABSolute type nenber(s} to be deleted. 


(optional) list of PPU type member(s) to be deleted. 


{optional) tist of PP type member(s) to be deleted. 


(optional) tist of CAP type member(s} to be deteted. 


(optional) tist of CCL (not SES) PROCedure member(s) to be 
deleted. 


lock or notlock : 


these f{optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the lock oarameter determines the 
name of the interlock file. Interlocking is the default 
action when the base being updated is tn another user's 
catalog. If you don't code either of the tock or  nolock 
keys» interlocking is controlled by the ftokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the ltlokmode 
profile variable and the tock and notock ovarameters. If 
you don*t code ai filename for the tock parameters the 
contents of profile variable iIntrl¥ok is used as the 
interlock filename; if there*s ro such profile variables 
the name intrtok is used as the tfock filename. The 
interlock File must be in the sane catalog as the base 
being updated. If the interlock file cannot be founds the 
procedure aborts. 


batch job parameters : 
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These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH J98S". The defauit for this 
procedure is to run in local modes but it can be run in 
batch mode. The dayfilte paraneter is not used by this 
procedures 


msg or nomsg : 


these {optional) keys contro! the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 


Example of WIPEMEM Usage 


sesewipemem tzthislibs text=(heavysusers)s retziast..access 


* 
*. 
¥ 
¥ 


DELETING MEMBERS FROM THISLIB 
NEW LIBRARY ON SESTMPL 

NEW LIBRARY NOW ON THISLIB 
SESTMPL PURGED 


REVERT. END WIPEMEM THISLIB 


This 


exampie of WIPEMEM illustrates the way In which muttipte 


lists of record types may be codeds and also shows a range of record 
types coded for the rel type. 
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6010 WIPULIB = _DELETE MEMBER(S) EROM USER _LISRARY 


WIPULIB is a special version of WIPEMEM for deteting (wiping) 
member(s) from a User LIBrary. LIBEDIT (the basis for these library 
management procedures) cantt handie user’ tibr'aries directiys so 
WIPULIB uses the LIBEDIT and LIBGEN utilities to perform the process 
correctly. Parameters to WIPULIB are : 


tor b: 
(optional) name of Library from which menber{s) are to be 
deleted. If you don*t code the 1! parameters WIPULIB uses 
the value of profile variable 1b as: the name of the 
library. If there's no such profite wariable defineds 
WIPULIB uses the name tib as the name of the tibrary. 


nivpor nb : 
{optional) name of New Library to be created at the end of 
the WIPULIB run. If you don*t code the nil parameter» 
WIPULIB uses the value of profile variable newlib as the 
name of the new tlibrary. If therets no such profile 
variabie defined, WIPULIB places the new ltbrary back over 
the old tibrary specified by the !: oarameter. 


un 3 
(optional) User Name in whose catalog the tlibrary 
specified by tif/nl is to be founds if t7nl’ is not in the 
catalog of the current user. If you don't code the un 
parameter, WIPULIB uses the value of profite variable 
fibown as the user name from whose catatog the library is 
to be obtaineds and if there*s no such variabie defineds 
WIPULIB uses the current user's catalog. 


mem or m or rel 3: 
list of member(s) to be deleted. 


lock or nolock : 
these (optional) parameters determine whether the base 
update process Is interlocked against simadtaneous updates; 
coding a filename for the lock parameter determines the 
name of the interlock file. Interlocking is the gefault 
action when the base being updated is in another user's 
catalog. If you don*t code either of the tock or  nolock 
keyss interlocking is controited hy the ftokmode profile 
variable. Refer to the introductory sections of this 
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chapter for information on the interactions of the tokmode 
profile variable and the ttock and notock parameters. If 
you dontt code a filename for the tock parameters the 
contents of profile variable intrtok is used as the 
interlock filename; if there*s no such orofile variables 
the name intriok is used as the tock filename. The 
interlock file must be in the sane catalog as the base 
being updated. If the intertock file cannot be founds the 
procedure aborts. 


batch job parameters : 


nx 


These parameters are described in the section entitted 
"SES PROCEDURES RUN AS BATCH J98S". The defauit for this 
procedure is to run in tocal modes hut it can be run in 
batch mode. The dayfite paraneter is not used by this 
procedure. 


this (optional) key indicates that when WIPULIB performs 
the LIBGEN portion of its jobs that LIBGEN should not 
build a cross reference of entry points in the ULIB 
record. You can set your own default for this parameter 
by defining the nx variabte in your’ profile (any non-null 
value causes the cross reference to not be built). Refer 
to the LIBGEN documentation in the N3S reference manual. 


msg or nomsg :? 


these (optional) keys control the generation of 
informative messages by this oerocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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6011 LIBEDIT =_ RUN _LIBEDIT UTILITY 


LIBEDIT is intended as a means of calling NOS LIBEDIT utility 
directly. Although SES library managenent orocedures use the 
LIBEDIT utitfity themselvess not all the functions of LIBEDIT are 
availables since SES procedures are oriented towards the most common 
functions. The LIBEDIT procedure gives you direct contro! over the 
LIBEDIT utility, but still provides ali SES convenience of ATTACHiIng 
your files for you and so one Parameters to LISEDIT are : 


g or group or ftgo :? 
{optional) name of file containing recordis) to be 
inserted or reptaced on the tibrary specified by 1. If 
you don't code the g parameter, LISENTT uses the value of 
profile variable groups and if there's no such variable 
defineds uses the default filenane group. 


for b: 
(optional) name of the old Library to he maniputated by 
LIBEDIT. If you don*tt code the ? parameters, LIBEDIT uses 
the value of profiite variable ib as the name of the 
librarys and if there*s no such variable defineds LIBEDIT 
uses the defauit name of tib. 


nfipoor nb 3 
(optional) name of the New Library after the LIBEDIT rune 
If you don't code the nl parameters LIBEDIT uses the value 
cf profile variabie newlibs and if there's no such 
variable defineds the LIBEDIT writes the new library back 
on top of the library specified by 1. 


un 3 
{optional) User Name in whose catatog the library 
specified by t/nt is to be founds If t/nt is not in the 
catalog of the current user. If you don*t code the un 
parameters LIBEDIT uses the value of orofile variable 
libown as the user name from whose catalog the library is 
to be obtaineds and if there's no such variable defineds 
LIBEDIT uses the current user's catatog. 


Coptional) list of character strinas which represent 
LIBEDIT utility directives. Using the i varameters, it is 
possible to perform many LIBEDIT onerations using a singte 
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contro! statement. If you don't code the 4 parameters 
LIBEDIT assumes the directives area coning from file INPUT. 
If you code the i parameter as a single names LIBEDIT 
assumes that it's the name of a file containing LIBEDIT 
directives. 


this (optional) parameter specifies the name of the file 
to receive the fisting output fron LIBENIT. If you donitt 
code this parameters LIBEDIT places its listing output on 
File OUTPUT. 


flock. or nolock 3: 

these (optional) parameters determine whether the base 
update process is interlocked against simultaneous updates; 
coding a filename for the fock oarameter determines the 
name of the interlock file. Interlocking is the default 
action when the base being updated is in another user'ts 
catalog. If you don*t code either of the tock or nolock 
keys» interlocking is controlled by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the flokmode 
profile variable and the lock and notock parameters. If 
you don*t code a filename for the tock parameters the 
contents of profile variable intritok is used as the 
intertock filenames; if there's no such profile variables 
the name intrfiok is used as the tock Filename. The 
interlock File gust be in the same catalog as the base 
being updated. If the interlock fife cannot be founds the 
procedure aborts.e 


msg ofr nomsg : 
these {optionat) keys control: the generation of 
informative messages by this orocedure and are “fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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Example of LIBEDIT Usage 


seselibedit lzproglib i=**isoviscatalogscatlistssesmsg! 
ee 

eooee here appears the output fron LIBEDIT utility 
* NEW LIBRARY ON SESTMPL 
*. NEW LIBRARY NOW ON PROGLIB 
*. SESTMPL PURGED 
REVERT. END LIBEDIT PROGLIB 


The exampte illustrates how the LIBEDIT utility input directive 
may be coded as a string parameter on the procedure call tine. The 
text preceded by periods indicates wheres in the actual use of 
LIBEDIT,s output from the LIBEDIT utility itself apoears. 


i= 
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720 GETTING _ INFORMATION 


This chapter describes a collection of SES porocedures to find out 


what's 


going 


on and what's available. There are two main areas of 


interest ? 


le Information about your locat environment on NOS - 
you. 
dayfile, 


what files 


your validation tlimits» the times parts of your 


and others. 


haves 


2e Information about SES - documents,s orocedures and status. 


CATLIST 


DAYFILE 


CATALOG 


FILES 


PERMIT 


LIMITS 


TIME 


DISPLAY 


DAYWEEK 


EXPLAIN 


CONVOLM 


display comprehensive information about files in a user's 


catalog. 

displays a selected part of your dayfile. 

gives a condensed list of the records in a Yibrary. 
local Files. 


display information about 


gives permission information for Files tn a user's catalog. 
displays your LIMITS information in a condensed format. 
"taiks™ the current time as a dayfite message. 

information about your job environment. 


dispiays various 


tells you what day of the week a date fell fails on 


(that iss today)» or will fali on. 


On» 


dispiays online manuals. 


converts online manual source to NIS/VE format. 
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TOOLDOC 


INFO 


USSINFO 


SESPROC 


SESPARM 


prints documents describing tools. 


displays the latest information about SES. 


displays the tatest information about User Supplied 
Software. 


generates a tist of names of SES orocedures. 


generates a printout of the paraneter tists of SES 
procedures in any selected procedure ftibrary. 
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Tel CATLIST =_D15 PLAY PERMANENT FILE _INEQRYATION 


CATLIST gives you a concise but very conorehensive tist of 
information about all files in a catalog. The files are tisted in 
alphabetical orders three Files per tines so that you can get 45 
files worth of information on one screenrntoad. The world goes by 
your window more stowlys so to speak. For each file in the 
specified cataitogs CATLIST outputs the information in the following 
Format 3 


FILENAM type category mode length 


where the different things displayed are ? 


FILENAM is of course the name of file in questions 


type is the access type for the file. ft is I for an [Indirect 
files and O for a Direct file. 


category is the security of the file. This field is PU for a PUblic 
files SP for a Semi Private files and PR for ao PRivate 
file. 


mode is the access mode for the file. This is one of R for 
Read» W for Writes M for Modifys A for Apnoends RM for Read 
Modifys and RA for Read Append and E for Execute. 


length is the fength of the file in PRUS»' 


For examples a typical line of ouwtout fron CATLIST would be 
like : 


MAILBOX I PU RA ool MAXBIN D PU R 342 PROFILE I PR R eel 


This tine of CATLIST output shows that MATLSOX is an Indirect 
access PUblic Read Append mode file of 1 prus MAXBIN is a Direct 
access PUblic Read mode file of 342 prus»s and PRNFILE is an Indirect 
access PRivate Read mode file of 1 pru,. 
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Parameters to CATLIST are 3 


un 3) 


pn : 


fpi : 


Note 


2 
2 


{optional) User Name of the italternate) catalog to be 
CATLISTed. If you don't code the un parameters the 
current user's catalog is CATLISTed. 


{optionai) Pack Name for files to be CATLISTed. If you 
don't code the pn parameters, the files on the default pack 
are CATLISTed. 


(optional) name of Fite to receive the Qutout from 
CATLIST. If you don't code the o oarameters, CATLIST uses 
file output. 


this (optional) parameter is used to tell CATLIST how many 
file descriptions it shoutd write on each iine of the 
output file. If specifieds the Files Per’ Line parameter 
must be given a numeric value fron 1 to 10. If you dontt 
code the fpi parameters, CATLIST generates 3 files per 
lines 


CATLIST can only handtie the first thousand files in a 


user's catalog. 


Example of CATLIST Usage 


The example befow shows a CATLIST for another’ user*s catalog. 


sesecatiist unz=is69 
CATLIST OF LS69 FOR LR78 ( 13 FILES» 10769 PRUS ) 


CSIOLIB 
DOCBASE 
002564. 
MAILBOX 
UTILITY 
REVERT. 


D 
D 
D 
I 
D 


SP R 2167 CSTOPL. D SP R 2585 DICTION © SP R 2125 
SP R 1158 DOLPL64 D SP R 2255 DOZR64. D SP R 2347 
SP R 2783 INTRLOK D PU R 229 ISOLLIB © SP R «237 
SP W e026 PROCLIB D SP R 2409 PROGLIB D SP R 6126 
SP R 2.971 


END CATLIST 
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7o2 DAYEILE =_DISPLAY SELECTED PORTIONS OF _DAYEILE 


DAYFILE displays either the last 14 lines: of your dayfiles or to 
dispiay any number of tines starting at a specified character 
strings Parameters to DAYFILE are 3: 


nor tist : 
(optional) number of lines of dayfile to display. If you 
don't code the n parameters DAYFILE displays 14 lines. 


find : 
(optional) character string at which to start displaying 
the dayfile. If you don't code the find parameters 
DAYFILE always goes to the line specified by tast_line-n. 
If you code a character string for this parameters DAYFILE 
goes to the fast occurrence of that character strings then 
dispiays n lines starting from that string. 


o or output : 
(optional) name of file to receive the output from 
DAYFILE. If you dontt code the o parameters, DAYFILE uses 
file output. 


Note : If you code the find parameters the ? character may not be 
a part of the character strings as ? is used as the string 
delimiter for the search. 
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7o3 CATALOG = SHOW LIST OF RECORDS _IN_A_EFILE: 


CATALOG performs the NOS CATALOG operation on a file. The NOS 
CATALOG utility outputs ai targe amount of information about the 
records,s most of which is never used. The SES CATALOG procedure 
outputs a condensed form of the information: fron CATALOGs showing 
oniy the record names and their typass. CATALOG outputs its 
information in the form 3: 


RECNAME TYPE RECNAME TYPE RECNAME: TYPE RECNAME TYPE 


four record names and their types are disotayed on one tines so that 
if you'tre using a (713) terminals, the nanes and types of sixty 
records can be displayed before the infornatior goes of f the top of 
the screen. The worid goes by your window nore slowlys so to speak. 
Parameters to CATALOG are : 


lor bi? 
name of Library or Base whose contents are to be 
CATALOGED. CATALOG is so arranged that if the file to be 
CATALOGed is tocal to your running job at the time the 
CATALOG runsys the file isntt RETIRNed.: If the Flle is not 
focal when CATALOG runss CATALOG GETs or ATTACHes the file 
for yous and RETURNs it when it has been CATALOGed. 


(optional) User Name in whose catatog the file is to be 
founds if the file is not in the catatog of the current 
user. 


o or output : 
(optional) name of file to receive the OQutput from 
CATALOG. If you don't code the o par'amaters, CATALOG uses 
file output. 


short or fong 2 
these (optional) keys determine the format of the output 
from CATALOG. If you omit this oarameter or code the 
short key» CATALOG produces its sutput in the form shown 
in the exampte below. If you code the tong keys CATALOG 
produces its output in the same format as the NOS utility 
CATALOG. 


See also the descriptions of procedures CATBASE: and CATLIB which 
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provide useful defaulting of the 1! and un var ameters. 


Example of CATALOG Usage 
This exampte shows a CATALOG operation oeoerformed on a library 
from another user's catatiog. The CATALOG procedure obtains the 
library», and returns it when it has finished. 


sesecatalog afiles un=jf73 


CCEFMGR.-OPLC CEDM ee oe e UPL CEDTEXT.».OPL CIOINT.22O0PL 
CRACKes eee DPL EDBLD. eee MPL EFMGR ee'e'e IPL ENVINIT..OPL 
EPBLDeeeeDPL FMTMSG.2eOPL MSGDICT..OPL PINESCeeeOPL 
POUTESC..OPL PUSHERR..OPL REPERR o/e'e OPL SFSKEOL..OPL 
SFWTIL eeeDPL SRCHMS Ge. eGPL STRTUP ooo MPL. TES eesveeed PL 
AFILEs.eee0PLD 

REVERT. END CATALGG AFILE 
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7o4 ELLES =_DISPLAY LOCAL FILE _INEQRMATION 


FILES gives you a concise fist of infornation about your focal 
filese The output of FILES is a compressed form of the output from 
the NOS utility ENQUIREsF. Parameters to FILES are 3 


o or output : 
(optional) specifies the name of the File to receive the 
local file information. If you don’t code this parameters 
FILES uses file output. 


all: 
if you code this (optional) key» FILES includes in its 
output some files that are nornally not included because 
they are always present (@eges TN®UT#s, INPUTs and GUTPUT). 
Example of FILES Usage 
ses.efiles 
LBSRC7O 22817 PM. UTILSRC .1447 PM* SCLEDIT eeee3 LOe 


GROUP ss 02012 LO- 
REVERT. END FILES 


The example shows FILES being used to fist local File information 
to the terminal. 
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75 PERMIT -_OBTAIN FULL _LIST_OF_ PERMISSION INEQRMATION 


PERMIT provides you with a permission information for all files 
in your catalogs» or for a selected list of Files» whereas if you use 
the NOS CATLIST utility» you can only tist oermissions one file at a 
time. Parameters to PERMIT are 3: 


o or output : 
(optional) name of file to receive the Output from PERMIT. 
If you don't code the o paraneters PERMIT uses file 
output. 


f or fn : | 
(optional) tist of File Names: for” which you wish the 
permission information to be produced. If you dontt code 
the f parameters PERMIT gives the Information for ali 
Files in your catalog. 


Exampie of PERMIT Usage 


sesepermit fnzproclib 


CATALOG OF WRB FM/CLSH176 89/10/28. 08.5642. 
PROCLIB 

le SES READ 3 BO/10/17- 09.43.18. 

2. SESAUX READ 1 80/10/28. 08.44.33. 

3e SLE READ 1 80/10/28. 082500296 

4. EFT READ 1 80/10/28. 08.54.58. 


This example ilifustrates a typical use of PERMIT, The output 
from the PERMIT procedure ts as that of the standard NOS CATLIST 
utility. 


7-10 
COC - SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: GA 
720 GETTING INFORMATION 
726 LIMITS - DISPLAY VALIDATION LIMITS 


7o6 LIMITS =_ DISPLAY VALIDATION LIMITS 


LIMITS provides you with a condensed version of the display that 
youtd get by using the NOS LIMITS contro! statement. The LIMITS 
control statement uses 35 tines to display the Information. By 
using this LIMITS procedures you get that infornation in five tines» 
thereby conserving space. Parameters to LIMITS are : 


0 or output : 
{optional) name of file to receive the Output from LIMITS. 
If you don*tt code the o paraneters LIMITS ptaces the 
display on file OUTPUT. 


Note that this LIMITS procedure formats the LIMITS data such that 
the word UNLIMITED is represented by an asterisk (*). 


Exampte of LIMITS Usage 


This example shows the use of the LIMITS procedures and the 
typical output generated by it. 


seselimits 

UI=612 ABz»s ABs,» ABz» <AB*» MT=¥y RP, TLa¥®» CMa*®,y NF ak, 
DB=*, FCe*¥, CS2*,y FS**®y PAZEVENs RO=SYSTEMs PX*HALF,s, TT2TTYs 
TC2ASCIIs IS*BATCHs MS2*¥_y DFe*s CCat, OF at, CPety LPat, 
ECz¥, Siz*,y CNe,y PNey DS2*#_y AW200007777777700007557 

REVERT. END LIMITS 
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7o7 TIME =_ DISPLAY CURRENT _TIME_GE_DAY 


TIME is a quick way of finding the tine (to the nearest five 
minutes). The SES TIME procedure “talxs" the time as a dayfile 
messages for example 3 


sesetime 
REVERT. TWENTY FIVE PAST TWELVE 
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7o8 DISPLAY =_DISPLAY VARIOUS USEFUL INEORYATION 


DISPLAY provides you with an easy way to ask for the display of 
odd things such as the job control registers» field tength»s 
switchess date» time and so one You can reauest the display of many 
things at a time. The dispiay is formatted in a “dense™ fashions to 
minimize the number of tines of screen used.’ Ther‘’e are only two 
parameters to DISPLAY that require values» the rest are just keys to 
indicate what you want displayed. The two oaraneters are the expr 
or e parameters, described belows and the o parameter which 
determines which file the display goes to. The dispfiay goes to file 
output by default. Keys indicate to DISPLAY what you want to know. 
You use DISPLAY JVike this °: 


sesedisplay thingls thing2s thing3s etc. 

where the "things™ are any or all of the keys described here. 

key whats displaved 

expr or e displays the value of any valid SES expression. A tist 
of the arithmetic operators available for expressions is 
given in the description of the YATH vrocedure below. A 
full description of the syntax of expressions can be 
found in the SES Procedure Writer*s Guide. 

date displays the current date in the forn 3: AUG 1l»s 1978 

time "talks" the time in the form : TWENTY FIVE TO ELEVEN. 


The time given in this forn is always rounded to the 
nearest five minutes. 


clock displays the clock time in the form 2? 4323 PM 

a | displays your current Field Length 

rl displays the contents of job control register R1 

r2 displays the contents of job contro! register R2 

r3 displays the contents of job control! register R3 

rig displays the contents of job contro! register R16 

ef displays the contents of the Error Flag 

efg displays the contents of the Glohal Error Flag 

jcr disptays the contents of ati four Job Control Registers,» 


Rl» R2s R3 and EFe 


Sw displays the six sense SWitches 1 to 6 In feft to right 
order. 
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ali displays ALL the above information 


Example of DISPLAY Jsage 


sesedisplay att 
FL = 4500018)» R1 = 4500s 10624(8)>. R2 = 0 
R3 = 6789s 15205(8)> R1G = Os EF = 0» EFG = Os 
SW = (UFsTsFoaTaToF ds JAN 253 1980s TWENTY PAST FOUR 
REVERT. END DISPLAY 
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7e9 DAYWEEK ~-_ DISPLAY DAY_OF THE WEEK 


DAYWEEK is used to determine what day of the week any date 
(including today) fell ony iss or witt fall on. Parameters to 
DAYWEEK are 3: 


day 3? 
(optional) specifies the number of the day in the month. 
If you don't code this parameters the current day of the 
month is usede 

month : 
(optional) specifies the month either as a number (1.212) 
or as a string (of which the first 3 characters are used). 
If you don't code this parameters the current month is 
used. 

year : 


(optional) specifies the year. Note that atl the digits 
of the year must be given. Tf you dontt code this 
parameters the current year is used. 


o or output : 
(optional) specifies the name of the File to receive the 
output from DAYWEEK. If you don't ende this parameter, 
DAYWEEK writes its output to file output. 
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7010 EXPLAIN = DISPLAY ONLINE MANUALS 


EXPLAIN is used to access the information avaitabte in SES = and 
NOS online manuals. If access is requested to a manual that does 
not exist at your sites the following message will be issued: 

COULD NOT FIND A MANUAL NAMED Cnanual_name> 


The parameters to EXPLAIN are? 


m 3 

(optional) name of the online manual to be accessed, If 
you dontt code the manual parameters EXPLAIN uses the 
default ontine manual menu named SESINFOs which allows you 
to access the available online nanuais by menu selection. 
The values that can currentiy be used on the manual 
parameter ares 

SES INFO - Gnline Manual Menu: 

TOOLS» SES ~ SES Users Handbook Ontine Manual 

CYBIL - CYBIL Online Reference Manual 

MISC -~ Miscellaneous Routines: Interface Reference 

Manual 
GRAPHs CADSG - NOS GRAPH Graphics Intine Users Handbook 


DEFINE, DD» CADSOD -—- NOS DEFINE Data Dictionary Tools Ontine 
Users Handbook 


CIO - Cyber Interactive Debug Inline Manual 

COMMAND ~ NOS COMMAND Online Reference Manual 

CONTEXT ~- Online Manual Reference YVanual 

FIN5s FORTRAN - FORTRAN Version 5 Ontine Reference Manual 

SORT5s SORT ~- SORT/MERGE Version 5 QIntine Reference 
Manual 


topic or t : 
(optional) string to be used in an index topic search of 
the named oantine manual. The antine manual witli be 
entered at the screen pointed to by the index topic given 
in this parameter, rather than at the main menu of the 
online manual. This parameter nust be specified in the 
form of a strings for examples t='this index topic’, 


Examples of EXPLAIN Usage 


ses.expiain 


7-16 
COC —- SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
7-0 GETTING INFORMATION 
7210 EXPLAIN - DISPLAY ONLINE MANUALS 


AP AAD AS AD A NR EA ND ON END RR A EN AED “END cee EN ED END CED ELD ND CEDD SITY END SEED SAD re -EY COEDS ERD END OR SDS ARTIS enn aN SIN ANNE HO D-IND “MED SERS AE NY OD gm cS eel A EN ND GP aD SED GD ED aD WN NOD ID A a ee 


REVERT.» END EXPLAIN 


seseexplain cybil 
REVERT.» END EXPLAIN CYBIL 


seseexplain maftn5 
REVERT. END EXPLAIN FINS 
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7ell CONVOLM =_ CONVERT ONLINE MANUAL SQURCE_TO_NODS/VE_FORMAT 


CONVGLM is used to convert NOS online wanualt source files to 
NOS/VE format. The converted online nanual source file must be 
moved to NOS/VE by the user. The parameters: to CONVOLM are : 


input or i or f 3 
name of the NOS online manual source tiInput file to be 
converted to NOS/VE format. 


output or o 3: 
(optional) name of the output File which will receive the 
converted online manual source file. If the output: 
parameter is not codeds the osutout aonvears on the file 
specified by the input parameter. 


listing or t 3: 
{optional) name of the lVisting File which will contain the 
error and statistics messages created during the 
conversion. If the tisting paraneter is not codeds the 
error/statistics output appears on a file called LISTING. 


Examples of CONVOLM Usage 
ses.econvoim iznosmans 
REVERT. END CONVOLM NOSMANS => NOSMANSsLISTING 


seseconvolm nosmans vemans 
REVERT. END CONVOLM NOSMANS => VEMANS» LISTING 


seseconvolm iznosmans ozvemans lestats: 
REVERT. END CONVOLM NOSMANS -> VEMANS»sSTATS 
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7612 LOOLDOC =. PRINI_IOQL DOCUMENT 


TOOLDOC is the means by which on—-fine and/or offe-tftine copies of 
TOOL DOCuments are made available. Parameters to TOOLDOC are : 


docs or d : 


This (optional) parameter is used to indicate which 
document(s) you wish to obtain. Document names are taken 
from the "document number™ column of the document index 
disptay (see the "doclist! parameter). The absence of this 
parameter will default the prac to display the entire 
document index. 


dociist or di : 


(optional) used to indicate that the document index is to 
be displayed - or retained on a File named by the 'tisting! 
parameter. The ‘'doctist' parameter is ignored if the 
'docs*' parameter is specified. Soecific portions of the 
document index are displayed by using the following keys 
with this parameter: 

CYBIL - CYBIL Compiler related documents. 

CADS ~ CADS retated documents. 

SCU - SCU related documents. 

C170 - SES Devetopment and Supoort toolsa: 

C180 - C180 Operating System developnent documents. 
M68000 — Motorolta 68000 retated documents. 

OTHER = Documents that don't fit into the categories 
above. 

Documents available onty at the tocal userts site. 
All of the above categories. This is the default 
if none of the above keys: are indicated. 


SITE 
ALL 


i 


listing or t 3: 


bin 


{optional) name of file to receive the document index 
display (when using TOOLODC without specifying any 
documentis))»s ofr the formatted docunent(s) themselves. If 
you code the fisting parameter to direct the document(s) or 
the document index to a tocal fille» that file is not 
printed. 


(optional) BIN number used at sites requiring bin numbers 
to indicate the bin number the outout fs to go toe If you 
don't code the bin parameters TIOLIGC uses the vatue of 
profile variable userbins and if therets 340 such variable 
defineds generates a bin number of NO-ID. 
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Note that the standard SES batch job oarameters are available. 
The default is to run the job in batch mode. 


Example of TOOLDOC Usage 


sesetoolidoc arhl1737 
10.36210. SUBMIT COMPLETE. JOBNAME IS AAEQAXA 
REVERT. J08 TOOLOOC SUBMITTED 


This example would cause the ERS for TXTFIRM to be printed on the 
system tine printer. 


sesetooldoc t=doctist tocal 
+. INDEX DISPLAY => DOCLIST 
REVERT. TOOLDOC DISPLAY COMPLETED 


This example copies the document index to the Fille DOCLIST. 
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7.13 INEQ - ACCESS SES INEQRMAILON 


INFD is a means whereby users may get uo to the minute bulletins 
on changes in SES» Parameter(s) to INFO are ?: 


o or output : 
(optional) name of file to receive the SButput from INFO. 
If you don?t code the o parameters INFOQ outputs the INFO 
file to DUTPUT. 
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7el4 USSINEO =_ ACCESS _USS_INEORMATION 


USSINFOQ is a means whereby users may get up to the minute 
bulletins on changes in User Supplied Software. Parameter{s) to 
USSINFO are : 


o or output : 
{optional) name of file to receive the outout from USSINFO. 
If you don't code the o paraneterys USSINFO outputs the 
USSINFO file to OUTPUT. 
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7elS SESPROC = LIST SES PROCEDURE NAMES 


SESPROC displays a tist of procedure nanes already used by SES. 
This is of use if you are a procedure writer and wish to create new 
procedures for use in SES- You can then use SESPRIC to ensure that 
there isn*t any name conflict. Parameters to SESPROC are 3 


un 3 
(optional) Jist of user names whose catalogs are to be 
searched for procedure libraries. SES uses the SES 
Library NAMe as the name of the orocedur’e tibrary to look 
for. If you don'tt code the un parameters SESPROC dispiays 
the names of procedures in the SESPLI8B of the current 
users and the names of procedures on SES tibrary. 


0 or output : 
(optional) name of file to receive the Qutput from 
SESPROC. If you don't code the o parameters SESPROC uses 
file output. 


Example of SESPROC Usage 


sesesesproc unzed73 
UN = ED73 
CETGEN COLLDOC COLLSUB EDTDIE EDTMOD: EDTSUB 
ICGEN MOVDOC MOVSUB PERT PRTDOC PRTSUB RELDOC 
RELSUB REPDGC REPSUB SENDKC WIPEDIC WYPESUB 
REVERT. END SESPROC 


This example shows SESPROC used to deternine the names of SES 
procedures in the SESPLIB of user ed73. 
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716 SESPARM =_ PRINT. PARAMETER REQUIREMENTS EDR SER PROCS 


SESPARM prints out the parameter definitions for all the 
procedures on atlibrary. It runs batch 9r fecal with batch as the 
default. Parameters to SESPARM are : 


name of Library whose parameters are to be printed. 


(optional) User Name where the library ts to be found. If 
you don't code the un parameters SESPARM assumes that the 
library is in the catalog of the current user. 


o or output or isting : 
(optional) name of file to receive the Qutout of SESPARM. 
If you dontt code the o parameters the output appears on 
file LISTING. 


batch job parameters ? 
These parameters are described tn the section entitled 
"SES PROCEDURES RUN AS BATCH J985". The default for this 
procedure is to run in batchn mode, but tt can be run iin 
focal modee The dayfiile paraneter Is not used by this 
procedures. 


print 3: 

{optional) parameter to contro! the PRINTing of the 
output. When the job runs in batchs one copy is printd 
automatically. If you run the orocedure in tocal modes no 
copies are printeds untess you: specifically code some 
print parameter. For examples you: coudd code printzc23 to 
obtain three copies of the paraneter listing. The format 
of the print parameter is that of the parameters for the 
PRINT procedures 


Note that the parameter tist of each procedure must terminate 
with a PARMEND directives or» for those records in a tibrary which 
don't have ao PARMEND directive by virtue of the fact that they're 
INCLUDE filess the parameter tist must be terminated by a 


" \ PARMEND 
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Example of SESPARM Usage 


sesesesparm tzproctib unzhk77 focal noprint: 


DEBUG 

\ PARM KEY = 'f! NVALS = Lee MAXVALS NAM 
\ PARM KEY = C*args*» *a*) NVALS = 1 STR 
\ PARM KEY = tpt NVALS = 1e'eMAXVALS NAM 
\  PARM KEY = #4 NVALS = 1 NAM 
\ PARM KEY = %e! NVALS = 1..MAXVALS STR 
\ PARM KEY = *xtd? NVALS = 1eeMAXVALS STR 
\ PARMEND 
2BRBSBERAZBIAZBASS 

DBUGFIN 

\ PARM KEY = (ti%, *F*) NVALS = 1 NAM 

\ PARM KEY = #48. NVALS = 1 STR 

\ PARM KEY = '"b* NVALS = 1 STR 

\ PARM KEY = lo NVALS = 1 NAM 

\ PARMEND: 


REVERT. END SESPARM PROCLIB/SHK77 -> OFTPUT 


Aithough this is a rather contrived examolte of a procedure 
library with onty two procedures in it» it illustrates the output 
that SESPARM generates. SESPARM is run in tocal modes or while you 
waits to produce the parameter definitions for procedures in fibrary 
proctib in the catalog of user hk7?7. The noprint key inhibits 
printing of the generated output. 


Explanation_of the outout af SESPAQM 


The diagram on the next page shows the atternative forms of 
parameter definitions of SES procedures. Afternative forms are 
arranged in the vertical columns. The blocks of text below provide 
a brief description of each field of a paraneter definition.e 
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\ PARMS KEY = CtKL ts K2t a cee Kit) NVALS = mineetax 


keyword —fumb 


a 


Ne Na a ee ee Ne ae ee eee 
2 


oe 


5 

3 

E 
This command starts 
the definition of an 
SES PARaMeter. 


ee 26 #28 6H we 


8 
KEY specifies the key-~- 
word or keywords that 
may be used when coding 
a parameter for an SES 
procedure. 


wos 26 we 28 2 4H £0 SH 4H © we OH 


NVALS specifies the Number’ of VAL 
that may be coded for a parameter. 

form mineemax indicates that’ a mini 
of "min®™ valuess and a maximun of “m 
values may be coded. If only one num 
is specifieds it means that the min 

max are the same. If NVALS soecifie 


value of zero (0)s5 then it indicates 


that there may be no vatues coded» 
that the parameter keyword is: used as 


option key. NVALS specified as 0D.'mnax 
indicates that the keyword may be used 
as an options or that it nay be given 


values. 


This field indicates the parameter type. [t may 
be NAMes NUMbers STRings or ForeiGN texte. Refer 


to the INTRODUCTION section for a descriotion of 
parameter types. 


If this field is coded in the parameter 


descriptions, it indicates that that paraneter is 
REQuireds and therefore may not be omitted. 
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ES PROCS 
NAM 
NUM 
STR REQ RNG 
er FGN: 


ues 
The 
mum 
ax” 
ber. 
and 
sa 


and 
an 


SH 68 20 £0 2b CGE Ob OH BH 420 GH 4H B26 4H BE CE BE 2h GH 2S 2H BO BE 6H 4H 4H BO HE 


Nn 
+ 
46 64 26 26 CE 26 6H 44 46 66 oO SE OH 4H GH 48 64 40 4H BH OS 66 bb BH DO BE 4S BH BE CO OH OO C4 


— 


If this field is coded in the parameter 


descriptions then it indicates that par‘ameter 


value(s) may be coded as a RaNGes that iss in the. 


form first.elast 


PNP NLS NLS 


i HO BS C8 68 CH BH BE 60 48 06 OH 86 BE OO CH O68 HH C8 6H O08 4H HE HH HH BE OF BH OH FO 4H 64 BE OS Be 6H Ge OS 
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8e0 FILESPACE MANAGEMENT 


SES provides some useful utilities to aid you in handling your 
Files. The procedures described here are : 


RETAIN. GETs or ATTACHes alt your fites to stop them being 
archived. 


DUMPPF 
LOADPF interfaces to a dump and iocad utility to orovide easy toa 
use dumping and toading of files. 


REWRITE provides a "safe" way to rewrite a file after it has been 
modified. 
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8.1 RETAIN =_ ACCESS _ALL_EFILES_IN_USERIS CATALOG 


RETAIN GETs or ATTACHes all your files to ensure that they aren't 
archived. RETAIN also provides the Ffacitity to CATALOG either 
designated filess or alt DIRECT access files: in your catalog. 
Parameters to RETAIN are 3 


batch job parameters : 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH JG35". RETAIN runs in batchn 
mode by default. RETAIN doesn't use the dayfile 
parameter. 


c or noprint : | 
(optional) coding c alone as a4 key causes all DIRECT 
access files in the catalog to be CATALOGed. Coding a 
jist of files for ec causes only those soacified files to 
be CATALOGed. Coding the noprint key suppresses ali 
output from RETAIN. 


s or short ;: 
coding the (optional) short key directs RETAIN to generate 
a short SES styte CATLIST outout instead of the NOS long 
form CATLIST. RETAIN generates the NIS style tong form 
CATLIST by defauit. 
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822 DUMPPE / LOADPFE_ = DUMP / LOAD PERMANENT FILES 


DUMPPF and LOADPF provide an easy way of dumping files to 
magnetic tape and retrieving them when required. DUMPPF and LOADPF 
use the same parameterss so they are described here together with 
variations explained as required. 


Note that DUMPPF and LOADPF interface to the permanent file 
utility RECLAIM. The parameters described hetow are ae minimal 
Subset of RECLAIM's capabilities that are needed to dump and load 
permanent files» RECLAIM creates and uses a database in the user's 
catalog; therefores a direct access file by the name of RECLDB 
Should not be purged. 


f or file or files :3 
{optional) list of files to be orncessed,' If you dontt 
give any File names,» all Files (or files determined by 
other selection criteria) are dunpoed or toaded. LOADPF 
#iiil not overwrite an existing fite by the same permanent 
file name. Therefores if overwriting is desireds those 
files should be purged beforehand. 


tape or vsn ; 
the VSN {volume serial number) of the tape that is to be 
used for dumping or loading. If the tane VSN is already 
present in file RECLDBs it may not be necessary to specify 
this parameter. 


seven or mt or nine or nt : 
(optional) indicates whether to us2 seven or nine track 
tapes The default is to use nine track. This parameter 
may be specified in the profile by the vartable tapetrk. 


dn or density : 
(optional) tape density to be used.’ Densities may be LO» 
HI and HY (default) for seven track tapes and HDs PE 
{defauit) and GE for nine track. This parameter may be 
specified in the profile by the variable tapeden. 


fmt or format : 
(optional) tape format to use. The default is I which is 
NOS Internale This parameter nay be specified in the 
profile by the variable tapefmt. 
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tapelist : 
coding this toptional) key witl cause ai tlisting to be 
produced that shows what files: area on the tape. It also 
gives other information such as file types tftengths date 
fast modifieds etc. 


ty or type ; 
(optional) TYPE of files to process. If vou don*t code the 
type parameters ali files will be orocessed (both direct 
and indirect). Other options are TY#*I' (to process only 
Indirect files) or TY=D (to process onty Direct files). 
The DUMPPF/LOADPF procedure doesnit check the validity of 
any options you code heres 


lo 3: 
this (optional) key directs the LIADPE orocedure to toad 
files as tocal files only. This paraneter may not be used 
wuhen dumping files. 


na or noabort : 
this (optional) key directs DUMPPFYLOADPF to NOt ABORT if 
any errors are encountered during orocessing. The normal 
defauit is to abort. 


xp 3 
(optional) eXtra Parameters which are ootions to be passed 
to RECLAIM. You code this itn the form of a character 
string. 


batch job parameters ; 
these parameters are described in the section entitled “SES 
PROCEDURES RUN AS BATCH JOBS* —- of the SES USER's Handbook. 
DUMPPF/LOADPF run in batch mode by default. 
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Examptes of DUMPPF / LOADPF: Usage 


sesedumppf vsnzbackup 
072482354 SUBMIT COMPLETE. JQGBNAME [S AGRIBUS 
REVERT. JOB DUMPPF SUBMITTED 


This is the simplest example of DUMPPF usages your entire catalog 
jis dumped to nine track tape backup. 


sesedumppf (wilsonsheathsnixonsagnew),» tapezabci23, dzhy 
19217215. SUBMIT COMPLETE. JOBNAME IS ABXTCUB 
REVERT. JOB DUMPPF SUBMITTED 


In this examples the four files in the parenthesised list are 
dumped to tape ABC123 where the tape Density (the d parameter) is 
set to HY (800 bpi) instead of the default PE (14609 bpi). 


seseloadpf tape=backup 
16242255. SUBMIT COMPLETE. JOBNAME [S ADRQBIT 
REVERT. JOB LOADPF SUBMITTED 


This example toads ali files from tana BACKUP, Note that 
existing permanent files are skipped during the toad of files from 
tape BACKUP. 
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8.3 BEWRITE ~_ REWRITE FILE 


REWRITE is mainly used as a building block for the source text 
maintenance and iibrary management. procedures» where rewriting of a 
base or fibrary is required. REWRITE is a "safe" way of performing 
the overwrite process. If for some reasor REWRITE fails to perform 
the rewrites it tries five (5) times before it gives up. Parameters 
to REWRITE are : 


ior rewritti : 
name of Input file to REWRITE. 


o or rewrito : 
name of Output file after the REWRITE process is complete. 
This is the new file created by the rewrite. 


un or rewritu : 
{optionai) User Name in whose catalog the file specified 
by o is to be founds if it fisn*t In the catalog of the 
current usere If you don*t code the un parameters REWRITE 
uses the user name of the current user’. 


status or sts 3 

these {optional) keys can be used for those cases where 
REWRITE is being used as a buitding block of more 
sophisticated procedures or jobs. The status key causes 
the REWRITE procedure to set the NOS job control register 
EFG to the vatue zero if REWRITE is successfully 
compfleteds and non zero if anything went wrong during the 
run of REWRITE. If status is not speacifieds the procedure 
will EXIT iff an error occurs. 


msg or nomsg : 
these {foptional) keys controt the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFIRMATIVE MESSAGES 
FROM SES PROCEDURES". 


Note : If the new file (given by the o oaraneter) is an existing 
INDIRECT access files it is REPLACEd. If the new file is an 
existing DIRECT access files REWRITE performs an overwrite process 
by ATTACHing the file in WRITE mode. If the new file doesntt exists 
REWRITE ODEFINEs the new file as a DIRECT access READ mode file 
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(thiss of courses can only be done if the un oar‘'ameter is omitted or 
is given as the user name of the current user). 
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9o0 COMPILINGs LINKING: AND DEBUGGING 


This section describes the SES proceduras available for compiling 
(assembling) programs written in various langquagess and for linking 
relocatables into executable form. The erocedures currently 
available in this category are 3 


CYBIL run the CYBIL compiler. 

CYBIL run the CYSIL compiler. 

ISWL run the ISWL CC compiler. 

SYMPL run the SYMPL compiler. 

FIN run the ForTraN extended conoiler,! 

FINS run the ForTraN-5 compiler. 

COBGL5 run the CO80L5 compiler. 

COMPASS run the CPU/SPPU ASSembler for the CYSER 170. 
ASM180 run the 180 ASseMbier for the CYRER 170, 
CPAS180 run the CPu ASsembler for the CYBER 180. 
PPAS180 run the PPu ASsembler for the CYBER 180. 
LINK170 fink relocatable binaries to forn an absolute program. 
XREFMAP generate a cross-reference fron a toad mape 


GETCCDB gets the CYBIL CC Interactive Debuqoger ready for use. 
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GETLIB{(S) get CYBIL run time tibrary tocal to the job. 


CYBENV run the CYBIL environment. 
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91 CYBIL =_RUN_CYBITL COMPILER 


CYBIL runs the compiler for the C9 CYRER IMPLEMENTATION 
LANGUAGE. The CC compiler is available to generate code to be run 
on. a CYBER 170 machinee The CI compiler is avaitabte to generate 
code to be run on a CYBER 180 machine. The M compitter is available 
to generate code to be run on a Motorola 63999 nicr’oprocessor. The 
CP compiler is available to generate UCSD ocode. The CS compiter is 
available to generate code to be run on a CYBER 2090 machine. 


The procedure is arranged so that it doas not abort. If there 
are any compile-time errors detecteds the NOS Job Control Register 
called EFG is set to a non-zero vaiuee This feature is used when 
this procedure is being used as a building blocks to determine what 
steps should be taken subsequent to running the conpiter. 


Parameters to the CYBIL procedure are ;: 


ior f 3: 
(optional) name of Input File ts be compiled. If you 
don't code the i parameters CY8IL assunes that the input 
is on a file calied compile. 


(optional) name of file to receive the Listing from the 
compiler. If you don't code the 1!) oarameters the compiler 
output appears on a file called tisting. This tisting 
File is not rewound by the CYBIL procedure. 


(optional) name of file to receive the Binary object code 
generated by the compiler. Tf you don*t code the 6b 
parameters the binaries appear 99 a file called tgo. This 
igo file is not rewound by the CY8IL orocedure. If you 
give a value of null to the b oarameters no binary is 
generated. 


cc or ci or cm or cp or ¢cs 3 
{optional) key determines the conpifer used. By defaults 
the CYBIL CC compiler is used. If you code the cl key» 
the CYBIL CI compiler is usede I[f you code the cm key» 
the CYBIL CM compiler is used.’ If vou code the cp key» 
the CYBIL CP compiler is useds I? you code the cs keys 
the CYBIL CS compiler is used. Note * vou can set your 
own default compiler selection in your profile by setting 
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a variable calied cybil to this kev. 


Note : this parameter is used to setect a version of the 
CC or CI or CM or CP or 3S conpiler other than the 
standard one released via the S&S. This is done by coding 
as a vatue for this parameter the user name of the owner 
of the compifer you're after. For eaxample,s entering 
cezlp3 accesses the version of the €C conpiter residing in 
the LP3 catalog. It is necessary for the owner of such a 
compiler to use the file name CY83ILC for the CC version or 
CYBILI for the CI version or CY3ILM for the CM version or 
CYBILP for the CP version or CY8ILS for the CS version in 
order to allow the compiler to be aecessed via this 
procedures For the CS versions the File CSTOSS must also 
be present in the owner's catalog. 


chk or re 3: 


io 


this (optional) parameter specifies the run-time checks 
the compiler is to generate. Tf you code no for this 
parameters no run<—time checking code is geanerated. If you 
code any combination of n (check for de-reference of NIL 
pointer), c¢ (check value ranges--range checking may add as 
much as 3 1/2 words to the generated object code for each 
range check performed) and gs (chack subscript ranges)s the 
corresponding checking code is. generated and omitted 
checking options cause the corresponding checks to be 
suppressed. If you) omit the chk parameters CYBIL 
generates all flavors of run-tine checks. 


this (optional) parameter specifies the Options to be used 
when producing the Listings. Any combination of the 
following designators may be coded For this parameter ;: 


a specifies that a map of the source’ input block 
structure and stack is to be produced 


f specifies that ae full listing is to be produced 
{setects tist options S» As and R) 


o specifies that the listing should include the generated 
object code in an assembler-like format 


s specifies that the listing of the source input file is 
to be produced 


w specifies that the listing of warning diagnostic 
messages is to be suppressed 
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r specifies that a symbolic cross referance tisting is to 
be produced 


ra specifies that a symbolic cross reference tisting of 


all program entities is to. be oroduced whether 
referenced or not 


x works in conjunction with the LISTEXT pragmat such that 
LISTings can be EXTernally controltted via the compiier 
cali statement. 


If no is specifieds no listing is oroduced. If the to 
parameter is omitteds a listing of the source input file 
only is produced. 


debug or dor nodebug : 


pad 


this teptional) parameter is used to setfect the debug 
options to be in effect for the compilation. The 
available debug options are 3: 


sd If this option is selectads the compiler incitudes 
Symbol Table information In the object code file to 
be used by the CYBIL interactive debugger. If this 
option is not selected it: Isnit: possibile to 
symbolically debug the module(s) being compiled. 


fd This option produces the same tables as dzsd pius 
stylizes the generated code to provide a step 
facility when using the synbolic debuaqger (it is only 
meaningful, currentlys when used with the Cc 
compiler). 


ds If this option is selected the Debugging Statements 
appearing between ?? nocompite ?? and ?? compile 2? 
pragmats is compileds otherwise such statements are 
skipped by the compiler. 


If you omit this parameter or you code the nodebug key» 
none of the sds fd oor ds options are selected. If you 
code the debug or d keys but don"t code any values» 
debug=sd is usede To select conbined options you can code 
debug=(sdsds) or debug=(fdsds). 


coding a numertc value for this (opttionat) pad parameter 
generates the specified number of no-ons between machine 
instructionse This feature is used for the P3 
diagnostics.e 
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opt : 
this (optional) parameter is used to select optimization. 
feveis in the generated code (not supported for ali 
compiler implementations). Legitimate values are ;: 


0 Provides for keeping constant values in registers. 
1 Provides for keeping local variables in registers. 


2 Eliminate redundant memory references and common 
subexpressions. 


msg or nomsg : 
these {optional) keys contro! the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 


Exampfe of CYBIL Usage 


sesecybil ftoz"or's chksz'tsnt 
REVERT. END CYBIL COMPILE -> LISTINGs LGD 


This example shows the CYBIL CC compiler being used to process 
the program on file COMPILE. A tisting Is: produced consisting of 
the source inputs generated object codes and a symbolic cross 
references on file LISTING.» The object code is written to file LGO 
and wilt include run-time checking code for Subscript ranges and NIL 
pointer de-reference. 
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9eo2 TiWh = RUN TS Wh CC COMPILER 


ISWL runs the ISWL CC compiler. 


The procedure is arranged so that if there are any compite-time 
errors detecteds the NOS Job Control Register called EFG is set to a 
non-zero valuee This feature is used when this procedure is being 
used as a building blocks to determine what stens should be taken 
subsequent to running the compiler. 


Parameters to the ISWL procedure are : 


ior f : 
(optional) name of Input File to he compiled. If you 
don't code the 4 parameters ISWL assumes that the input is 
on a file called compile. 


(optional) name of File to receive the Listing from the 
compiler. If you dontt code the { parameters the compiler 
output appears ona file called listing. This tisting 
file is not rewound by the ISWL procedure. 


(optional) name of file to receive the Binary object code 
generated by the compiler. If you don't code the b 
parameters the binaries appear 01 a file called tgo. This 
igo file is not rewound by the ISWL orocedure. 


lo 3: 
if this (optional) parameter is specified as gs a symbolic 
cross Reference map is produced on the File specified by 
the §! parameter. (R is the onty List Option available 
with this ISWL procedure.) If you dontt code this 
parameters ISWL does not produce a cross reference. 


small oor medium or targe : 

these (optional) keys are used to select the size of the 
ISWL compiler to be used, As you niaqaht have already 
guessed» three sizes are available. The default is medium 
but this can be over-ridden by defining In your profile a 
variable called iswisiz set to one of these keyse The 
compifter size determines how targe aémodule can be 
compilede 
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debug or nodebug : 
these (optional) keys select whether you want the compiler 
to generate (in the object code file) information for the 
ISWiL DEBUGger which runs under the SES SUBSYStem. If you 
code the debug key» ISWL generates the debug information. 
If you code the nodebug key or if you dontt code either of 
these keys» ISWL does not generate the debug information. 


msg or nomsg ; 
these (optional) keys control. the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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9o3 SYMPL_=_RUN_THE SYMPL COMPILER 


This procedure runs the SYMPL compiler for the CYBER 170. 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control! Register called EFG is set to a 
non-zero value. This feature is used when this procedure its being 
used as a building blocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the SYMPL procedure are :° 


ior f 3 
(optional) name of Input File to he compiled. If you 
dontt code the i parameters SYMPL assumes that the input 
is on a file called compiite. 


(optional) name of file to receive the Listing From the 
compiler. If you don't code the {! parameters the compiler 
output appears on a file calied tisting. This tisting 
File is not rewound by the SYMPL procedure. 


b 3 
(optional) name of file to receive the Binary object code 
generated by the compiler. If you don*t code the 0b 
parameters the binaries appear on a File catled Igo. This 
igo file is not rewound by the SYMPL orocedure. 


fo 3 
this (optionat) parameter is used to specify the List 
Qptions for the compilation (see the SYMPL reference 
manual for legal tist options). If vou don*t code this 
parameters, SYMPL uses only Jlist option Lt. 


this (optional) parameter is used to bass eXtra Parameters 
to the compiler (see the SYMPL reference nanual for a list 
of allowed SYMPL control statenent parameters). If you 
want to pass extra parameterss the list of them must be 
specified as a string (within single quotes). The SYMPL 
procedure does not check the validity of the parameters in 
the string. If you don’t code this parameters no extra 
parameters are passed to the comoiler.: 
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debug or nodebug : 
these (optional) keys select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CIO). If you code the debug key» SYMPL includes the 
debug information in the object code file. If you code 
the nodebug key or if you don't code either of these keys» 
SYMPL doesn't generate the debug information. 


msg or nomsg : _ 
these {optional) keys control the generation of 
informative messages by this orocsedure and are “fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*. 
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904 EIN-_RUN_THE FIN. CEORTRAN 4) _ COMPILES 


This procedure runs the FIN (ForTraN extended) compiler for the 
CYBER 170. 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register’ called EFG is set to a 
non-zero valsuee This feature is used when this orocedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the compiler. 


Parameters to the FTN procedure are 3 


ior f : 
Coptional) name of Input File to be compited. If you 
dontt code the i parameters FIN assumes that the input is 
ona file called compite.. 


(optional) name of file to receive the Listing From the 
compiler. If you don't code the ?: onarameter,s the compiler 
output appears on aefile called listing. This tisting 
file is not rewound by the FIN procedures 


(optional) name of file to receive the Binary object code 
generated by the compiler. If you don't code the b 
parameters the binaries appear 07 a fite called igo. This 
igo file is not rewound by the FTN: vorocedure. 


fi 


this (optional) parameter specifies the Field Length to be 
used while running the compiler. If you dontt code this 
parameter, FIN uses a field tength of 70900(8). 


this (optional) parameter is used to pass eXtra Parameters 
to the compiter (see the FIN reference manual For ai list 
of allowed FIN control statement paraneters). If you want 
to pass extra oparameterss the tlist of them must be 
specified as a string (within single quotes). The FIN 
procedure does not check the validity of the parameters in 
the string. If you don't code this voarameters, no extra 
parameters are passed to the comoifer.: 
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debug or nodebug ; 
these (optional) keys select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug keys FIN: Inctudes the debug 
information in the object code file. If you code the 
nodebug key or if you. don't code either of these keys» FIN 
doesnft generate the debug infornation,. 


msg or nomsg : 
these (optional) keys control the generation of 
informative messages by this oroscedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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9-5 FINS =_RUN_THE FINS _CEORTRAN=2)_ COMPILER. 


This procedure runs the FINS (ForTraNn=5e afso known as 
Fortran-77) compiler for the CYBER 170. 


The procedure Is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register called EFG is set to a 
non-zero values This feature is used when this orocedure is being 
used as a building blocks to determine what: steps should be taken 
subsequent to running the compiler. 


Parameters to the FINS procedure are ? 


ior f : 
(optional) name of Input Fite to be compited. If you 
don't code the i parameters FINS assunes that the input is 
ona file called compile. 


(optional) name of file to receive the Listing from the 
compiter. If you dontt code the # parameters the compiler 
output appears on aefile called listing.» This tisting 
file is not rewound by the FINS orocedure. 


b : 
{optional) name of file to receive the Binary object code 
generated by the compiler. TF you don*t code the b 
parameters the binaries appear on a file catted tgo. This 
igo fiie is not rewound by the FINS procedure. 

flo: 
this (optional) parameter specifies the Field Length to be 
used while running the compiler. If you dontt code this 
parameters FINS uses a field tength of 79000(8). 

xp 


this (optional) parameter ts used to oass: extra Parameters 
to the compiler (see the FIN5 reference manual for ai tist 
of alfowed FTN5 control statement parameters). If you 
want to pass extra parameterss the tist of them must be 
specified as a string (within single quotes). The FINS 
procedure does not check the validity of the parameters in 
the string. If you don't code this parameters no extra 
parameters are passed to the compiler.’ 


9-14 
CDC — SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User*ts Handbook REV: 4A 
9.0 COMPILINGs LINKINGs AND DEBUGGING 
925 FINS —- RUN THE FINS (FORTRAN—5) COMPILER 


debug or nodebug ; 
these (optional) keys select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug key» FINS includes the debug 
information in. the object code file.! If you code the 
nodebug key or if you don'*t code either of these keys» 
FINS doesn't generate the debug Infornation. 


msg or nomsg : 
these (optional) keys control: the generation of 
informative messages by this o2rocedure and are “fully 
described in the section entitited "INFORMATIVE MESSAGES 
FROM SES PROCEDURES"®. 
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906 COBOLS = RUN THE COBOLS COMPILER 


This procedure runs the COBOL5 compiter for the CYBER 170. 


The procedure is arranged so that if there are any compiler-time 
errors detecteds the NOS Job Controt Register called EFG is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building blocks, to determine what steos should be taken 
subsequent to running the compiter. 


Parameters to the COBOL5 procedure are : 


ior f : 
(optional) name of Input File to be compiled. If you 
don't code the fi parameters COBSIJL5 assumes that the input 
is on a file called compite. 


(optional) name of file to receive the Listing From the 
compiler. If you dontt code the 1! oarameters the compiler 
output appears ona file calted tisting.’ This tisting 
file is not rewound by the COB0L5 procedure. 


b 3: 
{optional) name of file to receive the Binary object code 
generated by the compiler. If you don*t code the 0b 
parameters the binaries appear 901 a file called Igoe This 
igo file is not rewound by the C3893L5 procedure. 

flo: 
this (optional) parameter specifies. the Filetd Length to be 
used white running the compiler. If you don?t code this 
parameters COBOL5 uses a field tergth of 70000(8). 

xp 5 


this (optional) parameter is used to sass extra parameters 
to the compiter (see the COB89DL5 reference manual for a 
{ist of allowed COBOL5 contro! statement oarameters). If 
you want to pass extra parameterss the tist of them must 
be specified as a string (within single quotes). The 
COBOL5 procedure does not check the validity of the 
parameters in the string. TF you don't code this 
parameters no extra parameters are oassed to the compiler. 
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debug or nodebug : 

these (optional) keys select whether you want the compiler 
to generate information for the CYBER Interactive Debugger 
(CID). If you code the debug keye °989L5 j$inctudes the 
debug information in the object code file. If you code 
the nodebug key or if you don't code aither of these keys» 
COBOL5 doesn't generate the debug Information. Note - 
this is not the COBOL5 debug option which can be selected 
via the DB parameter. This $OBOL5 debug option can be 
selected by using the xp parameter... 


mSgQ or nomsg 3 
these (optional) keys control the generation of 
informative messages by this oprosedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*. 
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9e7 COMPASS ~_RUN_THE COMPASS ASSEMBLER 


COMPASS runs the CPU/PPU assembler {COMPASS) for’ the CYBER 170. 


The procedure is arranged so that if there are any assemble-time 
errors detecteds the NOS Job Control Register calted EFG is set to a 
non-zero valuee This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the assembler. 


Parameters to the COMPASS procedure are 3° 


if or Ff 3: 
{optional) name of Input File to he assembied. If you 
don't code the 4 parameters COMPASS assumes that the input 
is on a file called compite. 


(optional) name of file to receive the Listing from the 
assembler. If you dontt code the 1 parameters the 
assembier output appears on a file catied listing. This 
fisting file is not rewound bv the COMPASS procedure. 
(Note that the assembier's contro! statenent parameter 0 
is set to the same file as soecified by the tL parameter 
only when the nomsg option (see below) is specified.) 


b 3 
(optional) name of file to receive the Binary object code 
generated by the assembler. If you don't code the b 
parameters the binaries appear on a file called tgo. This 
igo File is not rewound by the COMPASS procedure. 

a 
this (optional) parameter specifies the Field Length to be 
used while running the assembler.’ If you dontt code this 
parameters COMPASS uses a fieid Yenaqth of 7000018). 

xp 3 


this (optional) parameter is usej to oass eXtra Parameters 
to the assembler (see the COMPASS reference manual for a 
fist of aittowed control statenent parameters). If you 
want to pass extra parameterss the Jist of them must be 
specified as a string (within single aquotes). The COMPASS 
procedure does not check the validity of the parameters in 
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the string. If you don*t code this paraneters no extra 
parameters are passed to the assenbier,. 


¢ 


msg or nomsg : 
these (optional) keys control the generation of 
informative messages by this oerocedure and are “fully 
described in the section entitled "INFQRMATIVE MESSAGES 
FROM SES PROCEDURES", 
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98 ASM180_—_ EXECUTE THE.180 ASSEMBLER_ON_ 170 


ASM180 executes the 130 assembler on 179. This assembler shares 
a large percentage of common code with the one which executes in 
native mode. It produced object modules which nay be bound. 


Parameters to the ASM180 procedure are 3? 


f or input ;: 
(optional) name of the Input file to be assembled. If you 
don't code the i parameters ASM180 assunes that the input 
is on a file called input. 


b or binary : 
(optional) name of the file to receive the object code 
generated by the assembtier. Tf you dontt code the b 
parameter the object code will be written to a file cailed 
igo. This file is not rewound by the AS41830 procedure. 


! or fisting ;: 
(optional) name of the file to reaceive the Listing from 
the assembler. If you don*t code the 4 parameter the 
assembier output appears on a File called tisting. This 
file is not rewound by the ASM189 procedure. 


x or xref ; 
(optional) boolean parameter selecting a cross reference 
fisting. If you don't code this parameter no cross 
reference tisting is produced. 


¢ or checks : 
(optional) boolean parameter selecting whether the 
assembler checks for correct register types. If you dontt 
code this parameter the checks wil! be per formed. 


evt or convert 3 
(optional) If you don't code this parameter the file 
specified by the i parameter will be processed directty by 
the assembler. If you give onty the cyt parameter name 
the file specified by the i parameter will be passed 
through a program to convert the source statements from 
the form expected by CPAS180 to the Form orocessed by this 
assembler. If you give the cvt oarameter name anda “Ffile 
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name as its value that file will receive the converted 
source statements. 


st or status ; 
(optional) If this parameter is given a vatue of EFG or 
R1G»s those job contro! registers will be set to zero for 
no assembly errors and non-zero if there are assembly 
errorse 


msg or nomsg : 
These (optional) Keys control. the generation of 
informative messages by this orocedure and are fully 
described in the section entitled “INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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909 CPAS180_=_ RUN THE CPU ASSEMBLER FOR THE CYBER_180 


CPAS180 runs the CYBER 180 CPU assembter.: The procedure has two 
modes of operation : 


1. "normal mode" in which object code is generated from the 
source program 


22 "systext mode“ in which a "™system text"™ file is produced 
(containing pre-assembled PROCs» etc.) that is used tater as 
input to “normal mode" assembties (see the BLDSYST keyword 
parameter described below) 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register called EFG is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the assembier. 


Parameters to the CPAS180 procedure are 3. 


jor fF: 
(optional) name of Input Fit® to be assembied. If you 
don?t code the #§ parameter, CPASL80 assunes that the input 
is on a file caltted compite. 


1 3 
{optionat) name of file to receive the Listing from the 
assembler. If you don*t code the f parameters the 
assembler output appears on a file called tisting. This 
fisting file is not rewound by the CPAS180 procedure. 

b 3 
(optional) name of file to receive the Binary object code 
generated by the assembler, If you dontt code the b 
parameters the binaries appear on a file cafled Igoe This 
fgo file is not rewound by the ©°AS180 procedure. 

chk 3 


this (optional) parameter deternines whether the assembler 
checks for correct register types and instruction formats. 
If you code no for this parameters no checking of types 
and formats is done and the assenb!ler runs faster. If you 
code yes for this parameter or if you onfit the parameters, 
the assembler performs the checks,’ 
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$3 
this (optional) parameter is used to specify the name of a 
System text file. In "normal mode" this parameter is used 
to provide an alternate to the standard "SYSTEXT™ used by 
the assembler. In the "build systen text modes this 
parameter specifies the name of the file on which the 
system text is written (default is SYSTEXT). 


fi 3: 
this (optional) parameter specifies the Fleld Length to be 
used whife running the assembier. I* you don*t code this 
parameters CPAS180 uses a field tength of 70600(8). 


bidsyst : 
if you code this (optional) keys CPAS180 runs in the 
"BuiLD SYStem Text" mode» If you dontt code this keys 
CPAS180 runs in "normal" mode. 


msg or nomsg : 
these {optional) keys. control the generation of 
informative messages by this orocedure and are fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 
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9210 PPAS180_-_RUN_THE PPU ASSEMBLER FOR THE _CYSER_180 


PPAS180 runs the CYBER 180 PPU assembler. This assembler is a 
modified version of standard CYBER 170 COMPASS so that usage of the 
two assembfers is very similar. 


The procedure is arranged so that if there are any compile-time 
errors detecteds the NOS Job Control Register calted EFG is set to a 
non-zero value. This feature is used when this procedure is being 
used as a building blocks to determine what steps should be taken 
subsequent to running the assembler. 


Parameters to the PPAS180 procedure are : 


ior f 3 
{optional) name of Input File to be assembied. If you 
don't code the § parameters PPASI89 assumes that the input 
is on a file calied compile. 


} 3: 
(optional) name of file to receive the Listing from the 
assembler. If you don*t code the t #£parameters the 
assembler output appears on a file calted tisting. This 
listing file is not rewound by the PPAS180 procedure. 
{Note that the assembler's contro! statenent parameter O 
is set to the same file as snoecified by the L parameter 
onty when the nomsg option (see helow) is specified.) 

b 3 
(optional) name of file to receive the Binary object code 
generated by the assembler. If you dontt code the b 
parameters the binaries appear on a File called Iga. This 
ftgo file is not rewound by the PPAS139 procedure. 

fl 3 
this (optional) parameter specifies the Field Length to be 
used while running the assembier.' If you: don't code this 
parameters PPAS180 uses a field Ieangth of 7000018). 

xp 3 


this (optional) parameter is used to pass eXtra Parameters 
to the assembler (see the COMPASS reference manual for a 
jist of allowed controf statenent parameters). If you 
want to pass extra parameterss the fist of them must be 
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specified as a string (within single quotes). The PPAS180 
procedure does not check the validity of the parameters in 
the string. If you don't code this parameters no extra 
parameters are passed to the assenbier. 


mSg or nomsg : 


conv or 


these (optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES", 


convert : 

these (optional) keys specify that the output binary 
object code file (specified by the b parameter) is to be 
connected to the NOS/170 object text format that is 
described in the CYBER_ LOADER SEEEQENCE MANUAL. If this 
keyword is omitted the binary object code file produced is 
in the NOS/VE object text format. 
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Fell LINK1ZO_-_LINK_RELOCATABLE BINARIES 


LINK170 provides an easy way to use thea CYBER 170 Loader. 
Aithough the CYBER 170 Loader is very oowerful and fiexibles, it 
suffers from the disadvantage that you: cantt talk to it 
interactively» since it reads ahead in th2 control statement files 
and that means that you can only drive it via canned sequences of 
JCL. This procedure provides a simote to use Interface to the 
loader which allows for most common types of Ilinking. When using 
CYBIL screen formatting proceduress a *LIBRARYsSFLIB.® statement 
should precede the call to LINK170. The osrocedure ts arranged so 
that if any Vink errors are detecteds the NOS job control register 
EFG is set to a non-zero vatue. This allows the orocedure to be 
used as a buitding block for other procedures. Parameters to the 
LINK170 procedure are ; 


(optional) fist of Files containing the relocatable 
binaries that you want LINKed.' If you dontt code the f 
parameters LINK170 assumes that the relocatables are on 
file go. The fF parameter may be coded as a multi vatued 
list of sublists. Each element of the vatue fist is 
either a single names in which case it refers to the name 
of an object code file already assigned to the jobs or in 
the current user's catalogs gor an 2iement is a sublists in 
which cases the fast sub element In the subtist is a user 
name in whose catalog the object code filles referred to by 
the other sub elements of the sublist nay be found. The 
example at the end of this description should (with tuck) 
make this clear. Note that files for which a user name is 
specified are returned when the link is completed. 


{optional) name of fite to recelve the LINKed program. If 
you don't the b parameters LINK179 olaces the linked 
program on file igob. 


(optional) list of tJlibrary files from which external 
references are to be satisfied. The p oarameter may be 
coded as a multi valued list of sublists. Each element of 
the value fist is either a single names In which case _ it 
refers to the name of an user Vibr‘ary already assigned to 
the jobs or in the current user*s catalogs or an element 
is a sublists in which cases the Yast sub element in the 
subtist is a user name in whose cataioq the tftibraries 
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fo : 


ep : 


xid ; 


debug 


referred to by the other sub eleneants of the sublist may 
be found. The example at the end of this description 
should (with luck) make this clear. Note that tlibraries 
for which a user name is specified are returned when the 
link is completed. 


(optional) name of file to receive the nap Listing from 
LINK170.- If you don't code the 1 »sarameters the loader 
uses the default map file name (nornally output). 


{(ooptional) List GQetions for the LINK170 orocess. If you 
don't code the lo parameters, thea toader uses its defautt 
fist options. If you simply code io without any values 
supplieds LINK170 sets default vatues toesb. If you code 
fozfulls, LINK170 turns on FULL Tist options {which are 
fozsbex). QOtherwises LINK170 seats whatever fist options 
you Saye 


{optional) specifies a list of Entry Points to be inctuded 
in the header of a muiltipte entry soint “overtay™. This 
list is specified as a string exactly as the tist should 
appear on the NOGO toader directive (a string is used to 
afliow the specification of so-called “speciai™ entry 
points which have a syntax unacceptable to SES). 


{optional) list of eXtra Loader Directives. This 
parameter takes the form of a fist of character strings 
which are inserted into the contr‘ot statement streams in 
addition to those normally generateds thus allowing you to 
supply extra directives over and above the standard ones. 


(optional) controis whether the tinked program includes 
the CYBIL INTERACTIVE DEBUGger {(ClDBS?) or the CYBER 
INTERACTIVE DEBUGger (CID). Tf you code the debug 
parameters, the program wilt be able to be run under 
control of the requested debugger’ (by oraceding a calf to 
the program with the contro! statement DEBUG(ON)). Legal 
values are CCDBG and CID. If no value is givens CCDOBG is 
used. NOTE: if DEBUG is specifieds the tabtes used by the 
debugger are placed on file ZZZZ70T.. This file must also 
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be saved and made tocal if the absolute binary is to be 
used at a later time. 


iswitib or cybclib : 

(optional) key provides a conventerce when tinking 
programs written in the CYBIL or TSWL tanguage. If you 
are finking such a programs you: are advised to use the 
appropriate key for the language in auestions since such 
usage causes the LINK170 procedure to acquire the 
necessary library and generate any other necessary loader 
directives associated with LIN“ing a program in the 
designated tanguage. 


el or errlevi : 
this toptional) parameter controls: the Error Level at which 
the toader aborts without producing any absolutes. Valid 
vaiues for the el parameter are ? 


NONE onty “terminal™ errors cause an abort. 
FATAL onty fatal errors cause an abort. 
ALL all errors (both fatal and sonfatal) cause an abort. 
ALL is the default for LINKL790. 


A default vatue for the el parameter nay be set up via the 
errtevt profile variable if you dontt wish to keep 
overriding the default by coding the paraneter. 


Examples of LINK170 Usage 


seselink170 b=txtforms l=zmapforms to 
REVERT. END LINK170 TXTFORM 


This exampte shows LINK170 used to tink a program. The 
relocatable binaries are assumed to be on fille Yigqos and the LINKed 
program appears on file txtform. <A partial load map is written to 
file mapform. 


seselink170 pz=(mylibs youriib) themap full’ cybclib debug 
REVERT. END LINK170 LGOBs ZZZZZD0T 


This example itlustrates the use of multinote user tibrartes and 
in particular the use of the CYBIL run-time librarye The 
relocatable binaries are assumed to be on file tgos the tinked 
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program (with CYBIL INTERACTIVE DEBUG) is written to file tgob and a 
full toad map is written to file themap.' Debug symbol tables are 
written to file zzzzzdt. 


seselink170 bzabss pze(somelibs(utitlibs Jbfd)s ..) 
eo? Ff2l(retos oreos jee)) 
REVERT. END LINK170 ABS 


This example shows files reto and oreos belonging to user Jjees 
being linked using library somelibs which is efther’ local to the job 
or belongs to the current users and library utitt¥ib which belongs to 
user Jjbf. The ftinked program is written to File abs. Files relo» 
oreos and utillib are returned when the link ts conpteteds, but file 
somelib is left ltocal. 
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9.12 XREFMAP = _ GENERATE_A_CROSS_REFERENCE FRIM_A_LJAD_MAP 


XREFMAP is used to generate a neat cross-reference From ai toad 
mape XREFMAP outputs the cross-reference in 3 formats: module names 
with external referencess module name with it’s contained entry 
points and which external modules reference each entry points and a 
list of all entry points with containing module name and who 
references that entry point. Parameters to XREFMAP are 3: 


ior bi: 
name of toad map which is to be cross-referenced. The 
load map must have been created withs, at Yeast,» the LO=EX 
option on the LINK170 cail. 


un 3 
{optional) user name of catalo3 to search for input file. 
The default is the current user. 


(optional) name of the output file to receive the output 
from XREFMAP, If you dontt eode the ff parameters a 
default fisting fite name of LISTING is used. 


print or prt : 
this (optional) key controls the autonatic printing of the 
output file. 


batch job parameters ; 
These parameters are described in the section entitied 
"SES PROCEDURES RUN AS BATCH JOBS". The default for this 
procedure is to run in batch nodes but it can be run in 
focal mode. 
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913 GETCCDB -_ GET _CYBIL INTERACTIVE DEBUG 


GETCCDB provides an alternate way to acauire CYRIL INTERACTIVE 
DEBUG (CCDBG). Normallys CCDBG Is acquired when necessary by the 
LINK1i70 procedure. If the LINK170 procedure is not to be used in 
the current sessions, thoughs the necessary Files nust be explicitly 
attached. There are no parameters to the GETCCD8 orocedure. 


Example of GETCCDB Usage 


sesegetccdb 
REVERT. CYBIL INTERACTIVE DEBUG AVAILABLE 
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9014 GETLIB_OB GETLIBS = ACQUIRE LIBRARY COR_LINKING 


GETLIB(S) acquires the CYBCLIB or CYBILI3 tibrary ready for 
linkinge Parameters to GETLIBIS) are : 


cybciib or cybilib : 

; (optional) key indicates the library required to be made 
local. Coding the cybctib key acquires the CYBIL-CC 
library. Coding the cybilib key acquires the CYBIL-CI 
library. 


Exampies of GETLIB(S) Usage 


sesegetiib cybclib 
REVERT. END GETLIB CYBCLIB IS LOCAL: 


sesegetiibs cybilib 
REVERT. END GETLIBS CYBILIB IS LOCAL 
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9015 CYBENV =_RUN_CYBIL_ENVIRONMENT 


CYBENV provides a CYBIL environment with many options. 
Facilities inciude source code creation ant modification using FSE» 
source managements source formattings comoilings and FSE Interfaces 
in split screen for error corrections 


create or modify or compile or cybil_to set’ or’ set or add or 
get or tist base or delimod or delcom : 
(required) function name of CYBENY aotionr to execute. 


create - Lets you create the deck(s) specified by the m 
parameter using FSE and then adds the deckis) to the 
specified basee 


modify - Lets you modify the deck(s) specified by the m 
parameter using FSE and then reotaces the deck{s) to 
the specified base. 


compile - Compiles the deck({s)} specified by the m parameter. 
If there are compilation errorss you have the option 
of correcting the errors in the source using FSE in a 
sptit screen mode. The top part of the screen will 
be the source and the botton half wiit be the listing 
with the error message(s) under the Pines) with the 
error(s). You can also read the onfine CYBIL manual 
by pressing the ASSIST function key in FSE. 


cybil_to_sct or sct —- Produces structure charts of the specified 
deckis). There can be no convitation errors in the 
deck{s) specified or the structure charts will not be 
generated. You have an option of using the CADSG 
procedure to took at the structure charts produced. 


get - Gets deck(s) from the base specified and puts” the 
deckis) on the file specified by the g parameter. 


add ~ Adds deck(s) on the file specified by the g parameter 
to the base specified. 


detmod ~ Deletes deck(s) from the base svoecified. 
deicom - Deletes common deck(s) from the hase specified. 


Parameters to the CYBENV procedure are 3: 


moor alll 3 
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This (required) parameter specifles a list of modules 
{including ranges of modufes) that will be affected by the 
option specified. If the all key is codeads a compile file 
for ALL of the (regular? modules: in the svecified hbasel{s) 
is produced. 


bor i 3: 
Coptional) name of Base Library from which to generate the 
compile file. If you dontt code the b parameters CYBENV 
uses the value of profile variable base as the name of the 
base Jibrarys, and if there's no such variable defined» 
CYBENV uses the name base. 


(optional) User Name in whose catalog the base specified 
by b may be found. If you don't code the un parameters 
CYBENV uses the value of profile variable baseown as _ the 
name of the base librarys and if therets no such variable 
defineds CYBENY assumes that the base is in the current 
userts catalog. 


Note : If the User Name is different than the current users and 
using the modify or create optionss CYBENV will place the deck(s) 
on a base library that is the value of the profile variabie base» 
or the name base if no profile variable exists,’ The specified 
base fibrary in the different cataiog wilf then be added as an 
aiternate base,» 


(optional) name of file to receive the nodutes extracted 
from the base. If you don't code the g parameters CYBENV 
uses the name group as the name of the file. 


cors or c : 
(optional) name of file containing CORrection Sets to be 
temporarily applied against the base b prior to generating 
the compile file. If you code the cors voarameters, CYBENV 
uses procedure TEMPCOR to make the temnoorary corrections 
before generating the compile file. 


ab or al; 
(optional) list of Alternate Bases from which to satisfy 
calls to common modules. The ab Paraneter may be coded as 
a multi valued tist of sublists.’ Fach element of the 
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value jist is either a single rane»s in which case it 
refers to the name of an alternate base already assigned 
to the jobs or in the current userts catalog» of an 
element in a sublists in which cases the fast sub element 
in the sublist is a user name in whose catalog the bases 
referred to by the other sub elenents of the sublist may 
be founde See the example at the end of the description 
of GENCOMP to help make this clear. 


cybccmn or cybicmn : 


(optional) key specifies an SES sunpotiead Alternate Base for 
use in satisfying caltis to comnon modutes {see the ab 
parameter described above). If vou code the cybcemn key» 
the base containing CoMmoN modules for’ use by CYBIL CC 
programs is selected. If you code the cybicmn key» the 
base containing CoMmon modutes for’ use by CYBIL CI programs 
is selected. By defaults cybcenn is selected for use in 
generating the compile file. 


cc or ci or cm or cp or es 3 


io 


(optional) key determines the conpifer used. By default» 
the CYBIL CC compiler is used. If you code the ci key» 
the CYBIL CI compiler is used» If vou code the cm key,» 
the CYBIL CM compiler is used. If you: code the cp keys 
the CYBIL CP compiler is usede. If you code the cs keys 
the CYBIL CS compiler is used. Note * you can set your 
own default compiler selection in your’ profile by setting 
a variable calied cybil to this keys. 


this (optional) parameter specifies the Ootions to be used 
when producing the Listing. Any combination of the 
following designators may be coded for this parameter : 


a specifies that a map of the source input biock 
structure and stack is to be oroduced 


f specifies that a§full listing is to be produced 
(selects tist options S»s As and &) 


0 specifies that the listing should inctude the generated 
object code in an assembler-like format 


$s specifies that the Jisting of the source input file is 
to be produced 


w specifies that the tisting of warning diagnostic 
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messages is to be suporessed 


rf specifies that a symbolic cross reference tisting is to 
be produced 


ra specifies that a symbolic cross reference listing of 
al! program entities is to ba produced whether 
referenced or not 


x works in conjunction with the LISTEXT pragmat such that 
LISTings can be ExTernally conrtroiled via the compiler 
cali statement. 


If noo is specifieds, no listing is produced. If the to 
parameter is omitteds a listing of the source input file 
oniy is produced. 


chk or nochk : 
this (optional) parameter specifies: the run-time checks 
the compiler is to generate. If you code ng “For this 
parameter or nochk>» no run-time checking code is 
generated. If you code any combination of gn (check for 
de-reference of NIL pointer)» c (chesk value ranges—-range 
checking may add as much as 3 1/2? words to the generated 
object code for each range check performed) and s (check 
subscript ranges)» the corresponding checking code is 
gener ated and omitted checking options cause the 
corresponding checks to be suppressed. If you omit the 
chk parameters CYBIL generates: alf flavors of run-time 
checkse 


debug or d or nodebug :; 
this optional) parameter is used to select the debug 
options to be in effect for the compilation. The 
available debug options are 3: 


sd If this option is selecteds the compiler includes 
Symbot Table information in the object code file to 
be used by the CYBIL interactive debugger. If this 
option is not selected it isn*t possible to 
symbolically debug the modu!e{s) being compiied. 


fd This option produces the san2 tables as dszsd_ ptus 
stylizes the generated code to provide a step 
facility when using the symbolic debugger (it is only 
meaningful » currently» when used with the CC 
compiler). 
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opt 


bin : 


ds If this option is selected the Debugging Statements 
appearing between 7? nocomoite 7? and 2? compile 2? 
pragmats is compileds otherwise such statements are. 
skipped by the compiler. 


If you omit this parameters att! the debug options are 
selected. If you code the nodebug keys none of the sd» fd 
or ds options are selected. If you code the debug or d 
keys but don't code any vatuess debugssd is used. To 
select combined options you can code debug={sdsds) or 
debug=(fdsds). 


this (optional) parameter is used to select optimization 
levels in the generated code (not suoported for all 
compifer implementations). Legitimate values are 3: 


0 Provides for keeping constant values in registers. 
1 Provides for keeping tocal variables in registers. 


2 Eliminate redundant memory references and common 
subexpressionse 


Coptional) name of File to receive the Binary object code 
generated by the compiler. If you d4ontt code the bin 
parameters the binaries appear on a file calited tgo. If 
you give a value of null to the bin voaraneters no binary 
is generated. 
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10.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND STIMULATION 


10.0 CYBER_180_ VIRTUAL ENVIRONMENT CREATION AND SIMULATION 


"Simulation ain't what it*s going to be*® 
New Scientist 


This chapter describes the SES utilities for creating and using 
the CYBER 180 Virtual Environment on the CYBER 176. Facilities 
described in this chapter are : 

SIM180 run the CYBER 180 Hardware Systen Simulator’. 


TG180 convert aNOS/170 text file for use with the simulated 
NGOS/VE I/G avatiiable through the SIM189 procedure. 


T0170 NOS/170 to NOS/170 INTERFACE file conversion. 


FROM18O convert a simulated NOS/VE I/70 text File to a NQS/170 text 
file. 


FROM170 converts NOS/170 INTERFACE format Files to NOS/170 £=format. 


DUMP180 dumps the contents of a simulated NOS/VE fite. 


DUMP170 dumps the contents of a NOS/170 INTERFACE format file. 


GENC PF tink CYBER 180 binaries and generate a Checkpoint File. 


VELINK. fink CYBER 180 binaries and produce Segnert Files. 


VEGEN generate a CYBER 180 Checkpoint File from Segment Files. 


GETLIB(S) get CYBIL run time library tocal to job. 


GETDSI make HCS I0U Deadstart tape generator Iocal to job. 
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GETLDB make HCS NOS Environment Interface Loader tocal to job. 
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1001 SIM1L80_=_RUN_THE CYBER_180_ HARDWARE SYSTEM SIMULATOR 


SIM180 runs the CYBER 180 Hardware System Simulator (often 
referred to as the HSS). The hardware system that is simulated 
consists of the following components : 


1. CPU 

2e Central Memory (16 Megabytes) 

32 10(10) Peripheral Processors (??s) 

4. 12110) I/70 Channels 

5-2 2 7154 disk controllers sharing 4 844-4x disk storage 
unitse 

66 2 7155-1 disk controilers sharing 2? 844-4x and 2 885-1x 
disk storage units. 

72 2 7155-14 disk controti ters sharing 2 344=-4x, 2 885-1x 
and 2 885-42 disk storage units.’ 


SIM180 sets up the total system simulated environment and gives 
control to the CYBER 180 simulator. At this: osints the user may 
enter any valid simutator command. Simulator conmands provide the 
user with control over the simulated environment which includes the 
following capabilities :. 


1. CPU and PP memory toading 
2¢ Interpretive CPU and PP instruction execution 
3e CPU and PP breakpoint 
4. CPU and PP trace 
5- Display and change Central and PP? nemories 
6+ Dump Central and PP memories to a specified file 
7. Display and change CPU and P® registers 
Be Checkpoint / Restart 
9. On/off CPU and PP simulation 
10. CPU keypoint 
11. CPU program performance monitoring 


The CYBER 180 simulator is intended prinarily for interactive use 
({tocal mode) but may be readily used in batch. An exampie of batch 
submission of a Simulator run is given below. Parameters to SIM180 
are 3: 


restart or rs ;: 
(optional) name of a checkpoint file fron which to restart 
simulation. The checkpoint file may be one previously 
created by GENCPF (GENerate QheckPoint Eileds VEGEN 
(Yirtual Environment GENerator),» or via the simulator 
CHECKPOINT command. If you don't code the restart 
parameters, a complete simulated systen Is created. 
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cf 3 
(optional) name of a command file which is to be processed 
immediately upon activation of the sinulator. The command 
file consists of one or more valid simullator command(s). 
This parameter is required when running tn batch. 

4180 or i 3 


(optional) name of file containing inout for the special 
simulator CPU I/0 instruction {90 code FF{16)). If you're 
running SIM180 interactively and dontt code the i180 
parameters SIM180 takes its Input fron a File assigned to 
your terminal. If you run SIM189 in batch and use the CPU 
1/0. instruction for inputs you must supply a file 
containing the Input. 


0180 or o 3 
(optional) name of file to receive output from the special 
simulator CPU I/0 instruction (op eode FF(16)). If you'tre 
running SIM180 interactively and dontt code the 0180 
parameters SIM180 sends output to a Fite assigned to your 
terminal. If you run S$IM180 in batchs you must supply a 
file to receive the outputs otherwise the output is lost. 


Exampfes of SIM180 Usage 


sesesiml180 
** I SM 60523 CYBER 180 SIMULATOR VER 6.7 LEV 133 €MIGDS REV 3S) 


This exampite shows SIM180 used interactivetys to create ai new 
simulated system environment. The user may enter any simulator 
command once the simulator banner ts displayed. 


sesesim180 rsecheckl cfserrata 
** I SM 6052: CYBER 180 SIMULATOR VER 5.7 LEV 133 (MIGDS REV S) 


This example shows SIM180 used to resume simutation from a 
checkpoint file. The command file errata is orocessed before 
requesting additional simulator commands fron the user. 


sesesim180 checkx izindata ozoutdata 
** I SM 6052: CYBER 180 SIMULATOR VER 5-7 LEV 133 (MIGDS REV S) 
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This. examote shows SIM180 used interactively» to resume 
Simulation from the checkpoint file checkx. The special simulator 
CPU I/0 instructions when encountered durtng CPU instruction 
Simulations is to read input from file indata and Is to write output 
to file outdata. 


sesedo batchns filezsimefsecese 
ee? cs2#(%ses.siml180 postdss cfesimcfs orprogoutts.cs.2.ce 
ee? *savessesiog!) 

15254e28. SUBMIT COMPLETE. JOBNAME IS AAAQCBN 
REVERT. J08 0G SUBMITTED 


This example shows SIM180 submitted for batch running via the SES 
DD procedures Simulation will resume Fron the checkpoint file 
postds»s the simulator commands in the file simcf are processeds and 
any output from the special simulator CP) I70 instruction ts 
directed to file progout. Refer to the deseriiotion of the SES 00 
procedure in the "Miscellaneous Useful Goodies" section for an 
explanation of using DG to submit multiple control’ statements to 
batch. 
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1062 [Q180_-_NOS/170_TO_ SIMULATED NOS/VE_EILE CONVERSION 


TO180 converts a NOS/170 file containing character data to 
SIMULATED NOS/VE file format. OGnty character data can be converted. 
Parameters of TG180 are: 


ior f 3: 
The Input or File parameter specifies the NQS/170 format 
file to be converted. 


The (optional) Gutput parameter snoecifies the SIMULATED 
NOS/VE format file to receive the converted data. If this 
parameter is omitted then the output and input file names 
are the same. 


es612 or cs64 ; 
These (optional) keys indicate whether the NOS/170 format 
file is upper/tower case ascii (es612) or whether it is a 
64 character set ascii or display code file (cs64). If no 
keyword is given then cs612 is used. 
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10-3 [O0170.-_NOS/170_TO_NQ3/170_ INTERFACE FILE CONVERSION 


T0170 converts a NOS/170 file containing character data to the 
NOS/170 INTERFACE format of simulated NOS/VE 170. It is simitar to 
TO180 except that the output file content is: different. Parameters 
to T0170 are : 


ior f 3: 
Name of the Input Eile to be converted, 


(optional) name of file to receive the Qutouts that iss the 
NOS/170 INTERFACE format data. [f you don't code the oo 
parameters, the output appears on the File specified by the 
i parameter. 


es6l12 or cs64 :. 
these (optional) keys specify the character set of the 
input file. T0170 assumes the tnput File is in es612 
character set. 
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10.4 EROM18O = SIMULATED NOS/VE_TO_NOSZ170_EILE_ CONVERSION 


FROM180 converts a file in SIMULATED SOS/VE format containing 
character data to N0GS/170 format. Conversion stops whenever an 
error is found on the SIMULATED NOS/VE fornat file. Such errors 
include invalid record headers on the file and non-ASCII data in the 
records.e The NOS/170 format file may be oprintead with an SES.PRINT 
commands or input to any other normal NI5/170 programe. Parameters 
of FROM180 are 3 


ior f : 
The Input or File parameter specifies the source datas 
SIMULATED NOS/VE format File. 


o 
oe 


The (Coptionat) Gutput parameter’ soecifies the NO9$/170 
format file. If this parameter is omitted then Input and 
Output file names are the same, 


cs612 or cs64 3 
These keywords indicate the character’ set of the output» 
NOS/170 format file. Upper/tower case ASCII is indicated 
by the keyword cs612 and the keyword cs64& indicated a 64 
character set ASCII or display code. If this parameter is 
omitted then cs612 is used. 
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1065 EFROM170_-_NOS¢170_ INTERFACE TO _NOS/170_ETLE_ CONVERSION 


FROM170 converts NOS/170 INTERFACE format File containing 
character set data to NOS/170 format. ‘Tonversion stops when an 
error is found in the NOS/170 INTERFACE fornat file. Such errors 
include invalid record headers in the files and non ASCII data in 
the records. The NOS/170 file may be printed via the SES PRINT 
procedures or input to any other normal NI5/179 program. Parameters 
to FROM170 are : 


ior f 3: 
name of Input Eile to be converte’. 


(optional) name of file to receive the Qutout of FROM170. 
If you don't code the o parameters the output appears on 
the file specified by the # paraneter.: 


cs612 or cs6&4 ;: 
these {optional) keys specify the character set of the 
output files and correspond to the same parameters on the 
FROMi80 procedure. 


10-10 
CDC — SOFTWARE ENGINEERING SERVICES 
18 December 984 
SES User's Handbook REV: 4A 
10.0 CYBER 180 VIRTUAL ENVIRONMENT CREATION AND SIMULATION 
10.6 DUMP180 —- SIMULATED NOS/VE FILE DUMP 


SE ED A EE A EE ED I ED NS GE EG ON CE AD EN ath ED NE A NN OE ge AN AER AS <A AN «A ND XANES AD LA ATED ND <NODE 


10.6 DUMP180_ = SIMULATED NOS/VE_EILE DUMP 


DUMP180 dumps the contents of a simulated NOS/VE file. It is 
Simiftar to HEXDMP except that it checks the records and data 
structure of the file and diagnoses errors which prevent FROM180 
from converting the file. Parameters to DIJMP180 are : 


ior f 3 
name of the file to be dumped. 


{optional) name of file to receive the dump. If you dontt 
code the o parameters the dump outout appears on file 
output. 


cs612 or cs64 3 . 
these (optional) keys specify the character set of the 
output files as in the FROM1I80 procedure. 


fw: 
(optional) Eirst Word of the file to dump. The defautt is 
to start at word 0. 


iw: 
(optional) Last Word of the file to dump. The default is 
to dump up to end of information (CET). 
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10.7 DUMP170_ =_NOSZ170_INTEREACE FILE DUM? 


DUMP170 dumps the contents of a NOS/170 INTERFACE format file. 
It is similar to DUMP180» except that DUMP170 also checks the record 
and data structure of the input file and diagnoses errors which 
prevent FROM170 from converting the file. Parameters to DUMP170 
are: 


ior f 3 
name of the Input Eile to be dumpned.' 


Coptional) name of Qutput file to receive the dump. If you 
don't code the o parameters the output appears on file 
output. 


cs612 or cs64 ? 
these (optional) keys specify the character set of the 
output file. DUMP170 assumes the ¢s612 character set. 


(optional) Eirst Yord from which to start dumping. If you 
don't code the fw parameters the dump starts from word 0. 


(optional) Last Word to be dumped. IF you don't code the 
tw parameter, the dump goes to end of Information (EOI). 
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10.8 GENCPF_=- GENERATE A CHECKPOINT FILE (C2F) 


GENCPF executes the SES Virtual Environnent Linker and the SES 
Virtual Environment Generator to produce a Checkpoint File {CPF) 
which can be loaded and executed on the CYBER 180 Hardware System 
Simulator. The user must provide a File containing CYBER 180 object 
texts and can optionally provide a Linker Parameter File C(LPF)»s a 
set of Monitor Segment filess and/or a Virtual Environment Generator 
DIRective files The mf file contains the map produced by the 
Virtual Environment Linker and additional tnfornation produced by 
the Virtual Environment Generator. 


Note: most of the foltowing parameters arentt needed by the 
*general public” (examples show generat usage). 


Parameters to GENCPF are: 


ofi 3: (Filename(s)»s optional) 
Qbject_File_List - tist of us to 19 names of files 
containing CYBER 180 object text (ver 1.4). This 
parameter does not have a default. 


if! 3: (Filename(s)s optional) 
Library File List - fist of ue to 1) names of Library 
files containing CYBER 180 object taxt. This parameter 
does not have a default. 


pep : (String(31),.5 optional) 
Primary Entry Point - This paraneter soecifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symbol encountered. 


ns 2: (Stringl(4)» optional) 
Name _Seed - This parameter specifies the "name seed" for 
the Virtual Environment Linker Segqnent files. The default 
for this parameter is segme. The value of this parameter 
overrides any Linker Parameter File svecification of this 
field. 


mf 3 {Filenames optional) 
Map_File - This parameter specifies the name of the map 
file. The defauitt for this paraneter is tinkmap. 
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mo 3 


rewind 


tpf 3 


cpf 3 


cybilib 
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this {optional) parameter deternines the Jinker Map 
Qetions.e. mo determines the amount of information output on 
the linker mape Any value coded for mo overrides the 
default options chosen by the linker parameter file (LPF). 
The vaitue of the mo parameter is one of the following 
characters 3 


N no map information; diagnostics: are output. 

S$ Section altocations for every section of every input 
object module. 

E section alfocations plus Entry osoint names and address 
assignments. 

M section aliocations and entry points plus output 
segment and common block allocations (this last option 
is in fact a full linker map). 


or norew : 

these (optional) keys determina whether to REWIND the 
finker map File before writing it.’ The default action is 
to rewind the map file. The key coded overrides any tinker 
parameter file specifications. 


(optional) name of Linker _Parameter File containing Linker 
Parameters that affect the tink process. If you dontt code 
the tpf parameters, default vatues are apolied as in the 
description of the LPF. 


(Filenames optional) 


Checkpoint_File —- This parameter snecifies the name of the 
file containing the output from the Virtual Environment 
Gener ator. The default is ecofite..: The vatue of this 
parameter overrides any Linker Parameter File 
specification of this field. 


s {Keywords optional) 

If you code the (optional) keys GENCPF uses CYBILI8B to 
satisfy externals during the Linking process. GENCPF 
ACQUIRE'’s CYBILIB from SES and adds it to the 
Library_File_List. The default is' not to use CYBILIB as 
part of the Link. 


dir or tdrdir or d: (Filenames optional) 


Directives - This parameter specifies the name of a file 
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containing directives to the VE Generator. The default is 
a file containing default directives. 


mtrns or mns 3: (String{(4)» optional) 

Monitor Name_Seed ~- This paraneter specifies the "name 
seed" of the Virtual Environment: Linker Seqment files that 
contain the Monitor code. This: parameter is provided so 
users can have their own Monitor orograme The default for 
this parameter is mtrx. The orocedure checks the local 
files» the toca! PF catalogs and then the SES catalog to 
get the files. 


Examples of GENCPF Usage 


The following example shows how to compile a test orogram written in 
CYBILs generate a VE Files and run it on the Sinutlator. 


sesecybil ci iztestprg iztestist b=testigo 
sesegencpf ofiztestigo cpfxtestepf cybitib 
sesesiml80 restartztestcpf 

? run 

? bye 


The last two lines were Simulator commands. 


This example shows how to generate a CPF Fron several input files 
of CYBER 180 object text. 


sesegencpf ofiz(myligolsmy!go2) cpfsmycof 
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10.9 VELINK =_EXECUTE THE VIRTUAL ENVIRONMENT LINKER. 


VELINK executes the Virtual Environment: Linkers which links data 
from CYBER 180 object files/ltbraries and oroduces a map file and a 
set of SEGMent files. VELINK is set up so that users can specify 
their own Linker Parameter File (LPF) containing Virtual Environment 
Linker variables that control the linkage. 


Note? VELINK is generally used onty in special casess where 
GENCPF is inadequate. 


Parameters to VELINK are: 


of! 3: (Filename(s)» optional) 
Object _File_List - ist of up to 19 names of files 
containing CYBER 180 object text {ver 14). This 
parameter does not have a default. 


fis €Filtenamet{s)»s optional) 
Library _File_List - fist of uo to 19 names of Library 
files containing CYBER 180 object text, This parameter 
does not have a default. 


pep : (String(31)5 optionat) 
Primary_Entry_ Point - This paraneter’ specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer symboi encountered. 


ns 3: (String(4)5 optional) 
Name_Seed - This parameter specifies the "name seed” for 
the Virtual Environment Linker Segment files. The default 
for this parameter is segm. The value of this parameter 
overrides any Linker Parameter File specification of this 
Field. 


mf 3: (Fitenames optional) 
Map_File - This parameter specifies the name of the map 
file. The default for this parameter’ is tinkmap. The 
vaiue of this parameter overrides any Linker Parameter 
File specification of this field.’ 


mo ? 


2 
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this (eptional) parameter determines the linker Map 
Qetions. mo determines the amount of information output on 
the linker mape Any vatue coded for mo overrides the 
default options chosen by the linker oarameter file (LPF). 
The vatue of the mo parameter is ogne of the foilowing 
characters ?. 


N no map information; diagnostics ara output. 

$ Section allocations for every section of every input 
object module. 

E section allocations plus Entry ooint names and address 
assignments. 

M section allocations and entry pofnts plus output 
segment and common block atlocations (this last option 
is in fact a full linker map).’ 


rewind or norew : 


debug ;3 


(pf : 


these (optional) keys determine whether to REWIND the 
linker map file before writing it.: The default action is 
to rewind the map file. The key coded overrides any linker 
parameter file specifications. 


code this key if you want the tinker’ to generate ai file 
containing module address and entry point information. The 
file name is the name seed appended with 'DBGT. If you 
dontt code this keys no file is generated.) 


(optional) name of Linker_Parameter_File containing Linker 
parameters that affect the tink orocess. IF you don't code 
the tpf parameter, defauit values are applied as in the 
description of the LPF. 


cybifib : (Keywords optional) 


If you code the (optional) key» VELINK uses CYBILIB to 
satisfy externats during the titinking process» VELINK 
ACQUIRE*'s CYBILIB from SES and add it to the 
Library File List. The default is not to use CYBILIB as 
part of the Link. 


Exampie of VELINK Usage 
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In the following exampie the Linker is passed a Linker Parameter 
File. Object files york and hunt are linked using racelib as an 
object library. 


sesevelink oft=(yorkshunt) ifizmytib lof=mylipf 
REVERT. END VELINK 
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10.10 VEGEN =_ExXECUTE THE SES _VIRTUAL_ENVIRBONMENT GENERATOR 


VEGEN executes the SES Virtual Environment Generator to produce a 
Checkpoint File (CPF) which can be ftoaded and executed on the CYBER 
180 Hardware System Simulator. The input to the Virtual Envitonment 
Gener ator is the set of Segment files containing the users programs 
and a defauit set of segment files that contain a simple monitor 
programe The monitor program contains code that sets up the 
exchange packagess stack areas» and also oerovides aoe primitive 
Monitor and Trap Handler routiness and a Ternination routine. 


Note: VEGEN is generality used onity in special casess where GENCPF 
is inadequate. 


Parameters to VEGEN ares: 


dir or tdrdir or d 3: {Filenames optional): 
Directives - This parameter specifies the name of aie file 
containing directives to the VE Senerator. The default is 
a file containing default directives... 


ms ? (String(4),s optional). 
Name Seed ~- This parameter specifies the "name seed" of 
the Virtual Environment Linker Segment Files. The default 
for this parameter is segm. 


mtrns or mns : (String(4)s5 optional) 

Monitor Name Seed - This parameter specifies the "name 
seed" of the Virtual Environment Linker Segment files that 
contain the Monitor code. This sarameter Is provided = so 
users can have their own Monitor programe The default for 
this parameter is mtrx.e VEGEN checks the ftocal fitess the 
current user's catalogs and then the SES catalog to get 
the files. 


cpf = (Filenames optional) 
Checkpoint_File - This parameter’ specifies the name of the 
file containing the output fron the Virtual Environment 
Generator. The default is cpfile. 


mf : (Filenames optional) 
Map_File - This parameter specifies the name of the file 
on which to write the mao information. The default is 
tinkmap. 
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Example of VEGEN Usage 


In the following examples the Generator is Dassed a directive files 
a set of segment files containing the test orogram, a set of monitor 
filess and produces a CPF and Map file. 


sesevegen dirzemydir nsz*test* mtrnasztnatrx® cof=mycpof mf=mymap 
REVERT. END VEGEN: 
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10.11 GEILIB_OR GETLIBS _=_ ACQUIRE LIBRARY FOR_LINKING 


GETLIB(S) acquires the CYBCLIB or CYBILTS tltbrary ready for 
linking. Parameters to GETLIB(S) are : 


cybclib or cybitib : 
(optional) key indicates the tibrary required to be made 
local. Coding the cybclib key acquires the CYBIL-CC 
library. Coding the cybilib key acauires the CYBIL-CI 
library. 


Examples of GETLIB(S) Jsage 


sesegetiib cybctib 
REVERT. END GETLIB CYBCLIB IS COCAL 


sesegetlibs cybiltib. 
REVERT. END GETLIBS CYBILIB IS LOCAL 
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10.12 GETDSI_ =_ ACQUIRE BINARY FOR _ DEADSTART TAPE GENERATOR 


GETDOSI acquires the absolute binary to run the 4CS IGU deadstart 


tape generator. There are no parameters. 


Example of GETDSI Usage: 


sesegetdsi 
REVERT. END GETDSI VGENDSI IS toca’ 
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10.0 CYBER 180 VIRTUAL ENVIRONMENT CREATIIN AND STIMULATION 
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10213 GETLOB_ -_ ACQUIRE BINARY _FOR_ENVIRs INT. LOADER 
GETLDB acquires the absolute binary to run the HCS Environment 
Interface loader. There are no parameters.’ 
Example of GETLDB Usage. 


sesegetidbd 
REVERT. END GETLDB VGENLDOB IS LOCAL 
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11.0 MOTOROLA 68000 _ ENVIRONMENT 


This chapter describes the SES utilities for creating and using 
the Motorota 68000 Environment. Facilities: described in this 
chapter are 3 


ASM68K execute the MC68000 assembler.) 

LINK68K execute the MC68000 absolute linker. 

BIND68K create a single bound load module.’ 

TRANGSK generate a file of Motorola S$ records from the output 
fites of the MC68000 absolute linker. 

REFORM68K reformat a module to H=-P objact text format. 

BLDOMI68K generates an absolute module fron the output files of 
the MC68000 absolute linker. 

GENGS68K translates a global symbois File into H-P format. 

PURSYM68K removes debug symbol! tables» generated by CYBIL/CM or 


the MC68000 assemblers from nodules on object files or 
object libraries. 


TRANDILIB transiate DI libraries. 
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11.1 ASMO8K =_EXECUTE THE MOTOROLA 68000 ASS EMBLER_ON_170 


ASM68K executes the Motorola 68000 assenbler on the C170. 


This procedure is arranged so that it does not abort. If there 
are any assembiy-time errors detecteds the NOS Job Control Register 
called EFG is set to a non-zero vajue. When this procedure is being 
used as a buitding blocks this feature is used to determine what. 
steps should be taken subsequent to running the assembler. 


Parameters to the ASM68K procedure are 3 


i or input : 
(optional) name of the Input file to be assembled. If you 
dontt code the i parameters, ASM58% assunes that the input 
is on a file called input. 


b or binary : 
(optionai) name of the file to receive the object code 
generated by the assembler. If you don't code the b 
parameter the object code will be written to a file caited 
tgo. This file is not rewound by the ASM68K procedure. 


fl or tisting : 
(optionai) name of the file tos receive the Listing from 
the assembler. If you don't code the §& parameter the 
assembier output appears ona file called listing. This 
File is not rewound by the ASM68% procedure. 


x or xref 3; 
(optional) keyword parameter selecting a cross reference 
listing. If you don*t code this ovarameter no cross 
reference listing is produced. 


debug or d=: 
if you code this keys the assembler generates debug symbol 
tables in the object code file. IF you don*tt code this 
keys the assembler doesn't generate the debug Information. 


msg or nomsg ! 
These {optional) keys contro! the generation of 
informative messages by this orocedure and are fully 
described in the section entitted "INFORMATIVE MESSAGES 
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FROM SES PROCEDURES". 


col or cols or columns 3: (lefts right) 
(optional) left starting column and right ending column of 
source assembly tanguage statenents.,. The default vatues 
are (1290). 
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11.2 LINKOSK ~_ EXECUTE THE MC68000_ ABSOLUTE _LINGER 


LINK68K executes the MC68000 Absolute Linkers which tinks data 
from SES object files/libraries and produces a nao file and a set of 
SEGMent files. LINK68K is set up so that users can specify their 
own Linker Parameter File (LPF) containing 4C58090 Absolute Linker 
variables that control the tinkage. 


Parameters to LINK68K are: 


oft : (Filename(s)»s optional) 
Object _ File _Llist - list of uso to 10 names of files 
containing SES object text {ver 1.4). This parameter does 
not have a default. 


ifi : (Fitename{s)» optional) 
Library_File_List ~- list of up to 19 names of Library 
files containing SES object text.’ This parameter does not 
have a defauit. 


sp 2 (String(31),5 optional) 
Starting Procedure - This parameter specifies the entry 
point at which to start execution. The default is to 
start execution at the first Transfer synbol encountered. 


ns 3 (Stringl(4)5 optional) 
Name _Seed - This parameter specifies the “name seed" for 
the MC68000 Absolute Linker Segmant files. The default 
for this parameter is segme The value of this parameter 
overrides any Linker Parameter Fite soecification of this 
field. 


mf 2 (Filenames optional) 
Map_File - This parameter specifies the name of the map 
File. The default for this paraneter’ its tinkmap. The 
value of this parameter overrides any Linker Parameter 
File specification of this field.: 


this (optional) parameter deternines the linker Map 
Qetions. mo determines the amourt of information output on 
the linker mape Any value coded for mo overrides the 
default options chosen by the linker voaraneter fite (LPF). 


Coc - SOF 


SES User? 
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rewind 


ipf 3: 


cybmiib 


debug 3: 


In the fo 
File. 0 
object li 


The value of the mo parameter ifs gone of the following 
characters 3 


N no map information; diagnostics are output. 

S$ section allocations for every saction of every input 
object module. 

E section allocations plus Entry pofnt names and address 
assignments. 

M section allocations and entry ovpoints plus output 
segment and common block allocations (this fast option 
is in fact a full linker map). 


or norew : 

these f{optional) keys determine whether to REWIND the 
linker map file before writing it. The default action iis 
to rewind the map file. The key coded overrides any linker 
parameter file specifications. 


(optional) name of Linker_Parameter File containing Linker 
parameters that affect the fink process. If you don't code 
the ipf parameters defauit values are apoltied as in the 
description of the LPF. 


: (Keywords, optional) 

If you code this (optional) keys LINK468K uses CYBMLIB to 
satisfy externalts during the linking orocess. LINK68K 
ACQUIRE 's CYBMLIB from SES and add it to the 
Library_File List. The default is not to use CYBMLIB as 
part of the Link. 


code this key if you want the tinker to generate a file 
containing module address and entry point information. 
The file name is the name seed appended with *DBGt. If 
you don't code this keys no file is generated. 


Exampie of LINK68K Usage 


llowing exampie the Linker is passed a Linker Parameter 
bject files york and hunt are ftinked using myfib as an 
brarye 
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sesalink68k of f={yorkshunt) {flezmylib tpfenytpf 
REVERT. END LINK68K 
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11.3 BIND68K_-_ BIND MC68000_ MODULES 


The purpose of this command is to create a singie bound toad 
module from the specified component object or toad modules. The 
code sections of the old modules are combined into a singie code 
sections data sections with identical attributes: are combined into a 
single section and the binding sections are conbined and reorganized 
for nininum redundancy. Entry point definitions which are 
referenced from one or more component modules are deleted untess 
they have been explicitly retained on this conmand or they have been 
previously retained. 


Parameters to the BINDG68K are 3: 


file or f or tibrary or tib : 

This parameter may be coded as a nuiltivalued list of 
sublists. Each element of the value ltist is a single namey 
referring to the name of a file already assigned to the job 
or in the current user's catalog; or the element is a 
sublists the last sub-element in the sublist is a user name 
in whose catalog the files (or tibraries) referred to by 
the other sub-elements may be found. An exampte at the end 
Should help clear this up. 


name orn : 
This parameter specifies the motute name to be associated 
with the created modules 


module or modules or m ;: 
(optional) This parameter specifies the modules or module 
subranges from files or fibraries that are to be components 
of the created module. If not soacifieds ati the modutes 
on the specified files and Jibraries wilf be used as 
componentse 


retain or r 3 
(optional) This parameter specifies. the externality dectared 
names referenced by a component of the created module that 
are to be retained in the created nodule. Procedures that 
have been retained previously need not be respecified in 
this parameter. 


omit or o 3: 
{optional) This parameter specifies the externally declared 
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names in the component modules whose definitions are to be 
removed from the output module. 


starting procedure or sp ;: 
(optional) This parameter specifies the externally deciared 
name of the procedure at which execution is to begin. 
Omission causes tast transfer symbol encountered to be 
usede The starting procedure is always retained in the new 
module. 


upon or up 3 
This parameter specifies the File to contain the created 
module and the user name in whose catalog the file is to be 
placed. 


base or b or baselib or bl : 

(optional) This parameter specifies a File of object code 
modules that the upon file will bea added.! SES procedure 
GOF wilt be catlied if the keys b or base or just a file 
name is specified. GOL will be called if the keys basetib 
or bi are specified. GOF and GOL use the upon file as 
input and the base is rewritten with the created module as 
the fast mdodule. 


lock or nolock : 
(optional) These parameters deternine whether the library 
update process is interlocked against simultaneous updates. 
Coding a filename for the tock parameter determines the 
name of the interlock file. Interftocking is the default 
action when the upon file being updated is in another 
user's catalog. 


output or out : 
(optional) This parameter specifies the file name to which 
an object map of the newly created nodule is to be written. 


Ipf 3: 
{optional) This parameter specifies the File name of the 
file which contains the above paraneters as commands to 
BIND68K. This file must be tocalt to your jobe The 
following parameters and their optional names may be 
specified on this file: (FILEs MODILEs OMITs RETAIN» NAME>, 
STARTING _ PROCEDURE). 
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Examples of BIND68K Usage 


sesebind68k f=(mylibsstructs(sinescosinestanse. 
ftniib)) trig_functions spozstart unosbound 


The files mylib and struct are either already tlocal or pulled 
from your catalog. The files sines cosines and tan are in the 
ftniib catalog or iocal. The name of the new module will be 
trig _ functions and the new module will be on the file bound. 


s@sebind68k. ipf=bindipf outztist uponzobout: 
where bindlpf contains: 


FILEs(FILE1sFILE2) 
MODULE=(M0D1>sMO0D2»sM0QD3) 
RETAIN@( ENTIsENT2s o- 
ENT3»s ae 

ENT4s ee 

ENT5) 

NAME=NEWONE 

SP2TEST 

END 


The modules to be bound are obtained Fron files FILEL and FILE2. 
The modules bound are MOD1ls MOD2 and YOD3-: The entry points 
retained are ENT1 ees The new module's nane is NEWONEs and the 
starting procedure is TEST. The tisting fron 83IND58K is on file 
LIST and the bound module is on OBOUT. 
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11.4 [TRANOSK._=_ GENERATE 5 RECORDS 


TRAN68K generates a file of Motorola S$ records from the output 
Files of the MC68000 Absolute Linker, 


Parameters to TRAN68K are: 


hdr or h : 
name of the header file from the Absolute Linker. The file 
name has the form xxxxHDR from the tinker, This file 
contains information about the other Files needed to create 
the S$ records. 


srec or s 3 
name of file to receive the S$ records. 


Coptional) user number of catalog to search for hdr file 
and the other files needed. The default is the current 
usefre 


Example of TRAN68K Usage. 


sesetran68k segmhdr srecfii 
REVERT. END TRAN68K 


This example shows TRAN68K creating srecfil fron files that are 
specified by segmhdr in the current user's catalog. 
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11.5 REFQRM68K_=_ REFORMAT MODULE _TO_H=P_ QB2ECT TEXT EORMAT 


REFORM68K takes a retocatabte module fn the CDC object text. 
format and converts it to the H=-P format.’ Nne COC file with 
relocatable object text is reformatted into two fites which conform 
to the H-P format: 1) a file containing retocatable object code 
(known in the H-P world as a "reloc™ type File), and/or 2) a file 
containing the tocal symbots for each module (known to the H=-P world 
as an “asmb_usym" type file). One or both of these files can be 
generateds as needs dictate. The reformatted modulie(s) can then be 
downloaded for use on an H=-P 64000 workstation. This procedure will 
work on an input file with more than one nodude. Each module gets a 
separate record on each of the output fFfiles.! Parameters to 
REFORM68K are : 


input or i 3 
name of file containing the nodule or modules to be 
reformatted. 


output or o : 
(optional) name of file to receive reformatted module or 
modules. If you dontt code this parameters the vaiue of 
the profile variable hpreloc will be used (if it exists in 
your profite). 


symbols or sym : 
(optional) name of file to receive reformatted local 
symbols for a modute or modules. If you don't code this 
parameters the vatue of the profite variabte hpflocsym will 
be used (if it exists in your profile). 


(optional) user number of catalog to search for input file. 
The default is the current user. 


userid or uid : 
a string of up to 6 characters that is the user id from an 
H-P development station. 


fist or f ? 
a file to contain the Jtist of warning errors From 
REFORM68K. The default is to tist warning errors to 
output. 
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Exampie of REFORM458K Usage 


sesereform68k izcyrel un=cy170 ozhprel symehptsym uidzhpfile 
REVERT. END REFORM68K CYREL -> HPRELSHPLSYM 


The file cyrel is a file of CDC object text in the cataiog cyl170. 
The object text in H=-P format will be on a file named hpret. The 
local symbols will be on a file named hptisyn.:' The user id hpfile is 
part of the file hprel. 
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11.6 BLOMIO 8K -_ MEMORY _ IMAGE BUILDER 


BLDMI68K generates an absolute module from the output files of 
the MC68000 Absolute Linker. The file snecified by the hdr 
parameter is acquired by the procedure if it is not tocal. 


Parameters to BLDOMI458K are: 


name : 
this parameter specifies the modul@2 name to be associated 
with the created absotute module. 


hdr or h 3 
name of the header fite from the Absolute Linker. The file 
name has the form xxxxHDR from the tinkers where xxx is the 
name seed given by the tinker, This File contains 
information about the other files: needed to create the 
absolute module.. 


output or o 3: 
(optional) name of file to receive the new absolute module. 
If you don't code this parameters the default file name is 
MIBMOD. 


un 3 
(optional) user number of catalog to search for hdr file 
and the other files needed. The default is the current 
usere 


Example of BLOMI68K Usage 


sesebidmi68k abs _module segmhdr newmod 
REVERT. END BLDMI68K 


This exampte shows BLDMI68K creating an absolute module named 
abs_modute from files that are specified by segqmhdr’ in the current 
user's catalog. The new module will be on the File newmod. 
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11.7 GENG36O8K_-_TRANSLATES GLOBAL _SYMs_ FILE_LINTO_Y=P_ FORMAT 


GENGS68K accepts as input the 'DBG? file output From LINK68K (the 
debug keyword must be specified on the cal! to LINK68Ks or no *'DBG* 
file will be generated). The file is reformatted into an H=-P Linker 
Symbols File (also referred to in H-P manuals as a “fink sym" type 
file or “File Type 13"). The H-P formatted file can then be 
downloaded for use on an H-P 64000 work station. Parameters to 
GENGS68K are 3 


input or i 3 
{required) name of the linker synbols Fite output from 
LINK6 8K. The file name has the form txxxxDBGts» where xxx 
is the name seed used by LINK68X,.' 


output or o : 
(optional) name of a file to receive the H-P formatted 
Linker Symbols Fite. If not specifieds GENGS68K writes to 
a focal file named HPGSYM. 


userid or uid ;. 
(optional) 1-6 character H=-P user ide This is the same id 
entered on the HP64000 in response to the userid prompt. 
If defaulteds the then current 4-9? userid will be used 
when the file is used on the H-? station. 


un 3. 
{optional) user number of catalo3 to search for the input 
file. If not specifieds, the default is the current user. 


Exampte of GENGS68K Usage 


sesegengs68k izsjunedbg uid=hpid 
REVERT. END GENGS68K JUNEDBG => HPGSY™ 


In this examples the file named junedbg is a file of finker 
(iee@e» global) symbols; the H=-P formatted tinker symbols will be on 
a file named hpgsym and the user id *hpid*' is recorded in that file. 
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11.8 PURSYMO68K =_PURGE SYMBOL TABLES 


PURSYM68K removes debug symbol tables» generated by CYBIL/CM or 
the MC68000 assemblers from modules on object files or object 
libraries.» The input files are acquired by the procedure and _ the 
output files are rewritten as permanent files.' The same number of 
files must be specified for both the input and output parameters. 


Parameters to PURSYM68K are : 


input or i 3 
mame of file or Jlist of files containing debug symbo! 
tables. These files are acquired if they are not local. 
These files can be object files or object libraries. 


output or o : 
name of file or Jtist of files that do not contain debug 
symbo! tables when this procedure is finished. Ali these 
fiites are rewritten into the catalog of the user number 
specified. If the input file is an ohject files the output 
file will be an object file and the same hoids true _ (for 
object libraries. 


uA 3 
(optional) user number of catalog to search for input files 
and where to rewrite the output files. The defauit tis the 
current users 


Example of PURSYM&8K Usage 


sesepursym68k (exec monitor) (cexe mntr) 
REVERT. END PURSYM68K 


This exampie shows PURSYM68K removing debug symbo} tables from 
modules on the file exec and putting the nodules without symbol 
tables on the file cexee The same is done with monitor and mntr. 
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11.9 [RANDILIB_=_ TRANSLATE DI_LIBRARIES 


TRANDILIB packs object modules on object files or object 
libraries into byte oriented data manvings so the new file or 
library can be downloaded to the DI boxe. The object modules will 
appear to have been generated by CYBIL on the C189. The number of 
input files specified must be the same as the number of output files 
specified. 


Parameters to TRANDILIB are 3 


input or i 3: 
name of Fite or list of files to be transtated. These 
files are acquired if they are not local. 


output or o :. 
name of file or tist of files that have been transtated 
when this procedure is finished.! All these files are 
rewritten into the catalog of the user nunber specified. 


(optional) user number of catalogs to search for inout files 
and where to rewrite the output files. The defauit is the 
current usere 


file or f or fib or tf 3 
(optional) key specifies the fornat of the output files. 
If you code ftibs then a module directory and an entry point 
directory are included in the output files. If you don't 
code either keys then the default is file.: 


Example of TRANDILIB Usage 


sesetrandilib (Cobjfill objlib1l) Cobjfit2 objfil3) 
REVERT. END TRANDILIB 


This examptie shows TRANDILIB packing al! the object moduies on 
the object files objfills and the object Sfibrarvyvs, objtibls into 
packed object files objfil2 and objfil3. If vou had specified tib 
or 1! instead of files objfit2 and objfii3 would have been packed 
libraries. 
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12.0 UCSD PCODE ENVIRONMENT 


This chapter describes the SES utilities: for using the UCSD Pcode 
Environment. Facilities described in this chapter are :? 


REFORMP reformat module to UCSD Pcode object text format. 
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12.1 REFORMP_ ~_ REFORMAT MOD TO_UCSO PCODE 983 _ TEXT EORMAT 


REFORMP takes a retocatable module in the COT object text format 
and converts it to the UCSD Pcode format.’ The re-formatted module 
can then be downloaded to a UCSD Pcode Version IV.0 P=-system. This 
procedure will work on ai file with nore than one modules Each 
module gets a separate record on the output file. Parameters to 
REFORMP are 3: 


input or i 3 
name of file containing the nodule or modutes to be 
reformatted. 


output or o ? 
name of file to receive reformatted nodule or modules. The 
defauit name is PFILE. 


un 3 
(optional) user number of catalog to search for input file. 
The default is the current user. 


Exampte of REFORMP Usage 


sesereformp cyrel pfile unzcy170 


The file cyrel is a file of COC object text In the catalog cyl170. 
The object text in UCSD Pcode format wit! be on a File named pfilte. 
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13.0 3ES_ OBJECT CODE UTILITIES 


The Qbject Code Utitities. are a collection of commands which used 
to create and update librariess modify certain aspects of individual 
moduless and fist various types of information for each module. The 
utilities accept as input object modules in: loader text format V1.4 
generated by cross compilers and assemblers executing on CYBER 170 
CASMOBKs CYBIL-CI» CYBIL-CM and PCODE).} Yere is a brief summary of 
the Object Code Utility commands. The full descriotions foliow. 


COM Change Object Moduie. Changes characteristics of a 
module in an object tibrary.: 


DEOM DElete Object Module{s) from an object library. 
DIOM OQIspiay Qbject Module(s) information,’ 
GOL Generate Qbject Library. Senerates or updates an 


object tibrary. 


GOF Generate Qbject Eite. GOFF is sinitar to GOL», except 
that GOF produces a file which is not a tibrary. 


OBJLIST dispiays CDC ebject text in a readabte form. 
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Parameter Naming Convention for _Obiect Code Utilities 


This section introduces the parameter naning corvention common to 
most of the procedures in the SES Object Code tilities. 


file or tibrary 


module 


upon 


listing 


name of the object library (Cor File) on 
which the object modules reside. 


name of a module or range of modules 


name of new ffbrary for file) for those 
procedures which update a tibrary (or 
file). 


name of file to receive fisting 
information. 
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PROFILE Variables_for Object Code Utilities 


The variables described below may be dectared in your PROFILE in 
order to establish default information for the parameters of the SES 
Object Code Utilities procedures. 


lokmode used by all of the procedures that update ftibrariess, to 
determine the default interlock action.! fokmode may be set 
to one of *LOCK' or 'NOLOCK!. See also the sections below 
on updating tibraries and interlocking. 


intriok used by all of the procedures that uodate libraries to 
specify the intertock fite to be used during the update 
process» The default name for this file Is intrtok. 


13-4 
COC — SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 


13.0 SES OBJECT CODE UTILITIES 


interlock Process. for Updating a Library 


When updating a Jibrary you can interlock: the update so that only 
one user at atime can update the library. Yhose procedures that 
update a library are set up so that if the tibrary to be updated is 
in another userts catalogs the library is interfocked by default. 
You can override default actions by defining a tokmode variable in 
your profiles or by coding a fock or nolock: key on the procedures as 
shown in the diagram on the next page. 


Interlocking of a fiibrary is done via an inter'tlock file. Such a 
file must be a DIRECT access file in the sane usects catalog as the 
Libcracy being updated.» Naturally the intertock fite must he a 
PUBLICs WRITE MODE file if other users are tikely to be using it. 
The default name used by the SES Object Coda Utilities and tibrary 
management procedures for the tock File is tntritok.!) You can have an 
interlock file of any name by defining the Intriok orofite variables 
or by coding a file name as a value for the tock parameter on the 
appropriate procedures. 
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13.1 COM = CHANGE OBJECT MODULE 


COM Changes an Qbject Module in an object tibrary. Various 
characteristics of the module may be changed» such as entry point 
names which may be substituted or removeds gated entry points may be 
designated or removeds and commentary may be changed. Parameter to 
COM are : 


file or f or JTibrary or tib 3: 

name of file (or tlibrary) containing the module to be 
changeds pilus an (optional) user name specifying the 
catalog where the file (or library) resides if it is not in 
the current user's catalog. The soecified file may or may 
not be a Jlibrarys but if the keyword used is tib or 
fibrarys it must be a library. Whether the upon file is a 
library is determined by the format of this input file. If 
you code a file name and a user nanes they must appear as a 
jist, the first element of which Is the name of the files 
and the second element the nane of the user in whose 
catalog the file residess for exanote : Fe(dates paim) to 
get file date from the catalog of user palm. 


module or mo : 
name of the module in the library to be changed. 


(optional) name which reptaces the name of the specified 
module. 


(optional) entry point pairts) whose names are to be 
substituted. The pairs are of the form (<old entry 
point>s<new entry point>) where <old entry point> is 
replaced by <new entry point>d. 


omit oro: 
(optional) entry point{s) whose definitions are to be 
removed from the output module. 


gate or g: 
{optional) entry point(s) that are to be gated in the 
output module. Gated entry points’ can be entered from any 
ring within the files call brackat,.. 


13-7 
COC - SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: GA 
13.0 SES OBJECT CODE UTILITIES 
13.1 COM —- CHANGE OBJECT MODULE 


ng 2 
{optional) entry pointi{s) for which the gated attribute is 
to be removed. 


(optional) entry point at which execution is to begin 
(transfer symbol). 


comment or co ; 
(optional) contents of the commentary field in the module 
header. 


upon or up : 

name of file to receive the updated File (or library)» plus 
an (optional) user name in whose catalog the fite (or 
library) residess if the file or’ ltbrar'y) is not in the 
current user's catalog. Whether the upon file is a tibrary 
is determined by the format of tha Inout file. If you code 
a file name gnd a user names they nust be coded as a tists 
the first element of which is the name of the Files and the 
second element the user name in whose catatog the file 
resides. If you just code the file name and no user names 
the upon file is placed in the catalog of the current user. 
If the user name refers to another’ user's catatogs the upon 
file must already exist in that user's cataloge 


lock or nolock ; 

these (optional) parameters deternine whether the tibrary 
update process is interlocked against simuittaneous updates; 
coding a filename for the tock ‘parameter determines the 
name of the intertock file. Intertfocking is the defayit 
action when the library being updated is In another users 
catalog. If you dontt code either of the tock or notock 
keys» intertocking is controtted by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variable and the tock and nolock parameters. If 
you don't code a filename for the tock parameters the 
contents of profile variable intrtok: is used as the 
interlock filename; if there's no such orofile variabley 
the name intrtok {is used as the tock filename. The 
interlock file must be in the sane catalog as the tibrary 
being updatede If the interlock file cannot be founds the 
procedure aborts. 


13-8 
CDC =— SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: 4A 
13.0 SES OBJECT CODE UTILITIES 
13.1 COM —- CHANGE OBJECT MODULE 


ND LED ERD AD ED A AT AS-D AED NE GS AD ED A EE MEN ND ED NS ND ND A <A AE SEE se SD SR AE NAAN SS “ED RA A AN ND EY AE DOO AED AD | ND EAD AN OED NS A OD AE DD ele OD Ae ee ee 


msg or nomsg : , 
these (optional) keys control’ the generation of 
informative messages by this procedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*, 


Examples of COM Usage 


ses.ecom tlibraryzlibl modulesmodx nnzmody uvonelib2 
REVERT. MOOULE MODX CHANGED ON FILE LI82. 


This command creates anew tibrarys tib2? which is identical to 
library Yibl except that the name of modx is changed to mody. 


sesecom filel modx s=(Ceplsnewepl)stleo2snewen2}) ups (File2swrb) 
*. LOCKING FILE2 VIA INTRLOK 

* FILE2 LOCKED 

* FILE2 UNLOCKED 

REVERT. MODULE MODX CHANGED ON FILE FILE? 


This command creates anew file file2 (nay be tibrary) tdentical 
to filel except that entry point name neweol rentaces epl and newep2 
replaces ep2. The destin6ation files file2 is given with the user 
name wrbs so the automatic interlocking process takes piace during 
the update of file2. 


sesecom tibl mozmodulex ozentl gzent2 ngozent3 prozent4 e- 
eet coz*cpy migds review"® upstib2 
REVERT. MODULE MODULEX CHANGED ON FILE LIB2 


This command creates a new tibrary tib2 identical to tibl except 
that entry points in module modulex are modified as follows : entl 
is removed; ent2 is set to gated; ent3 is set to not gated; the 
transfer symbol! is changed to ent4; and the conmentary field is 
changed as showne 
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1362 DEOQM_=_DELETE_ O8JECT MOOULE(S) 


DEOM DEletes Qbject Module(s) or ranges of oh ject: modutes from an 
object library. Parameters to DEOM are 3. 


file or f or tibrary or tib : 

name of the file lor tfibraryv) from which modufe(s) or 
module subrange(s) are to be deleteds olus an (optional) 
user name in whose catalog the file or’ tibrary resides if 
it isntt in the current user's catalog. The specified file 
may or may not be a iibrarys but if the keyword used is Jib 
or ftibrarys it must be a tibrary. Whether the upon file is 
a Jlibrary is determined by the format of this input file. 
If you code a file name and a user’ names they must appear 
as a tists the first efement of which is the name of the 
files and the second element the name of the user in whose 
catalog the file residess for exanpie 3: fFef{coconuts paim) 
to get file coconut from the catalog of user palm. 


module or mo : 
module €s) or moduie subrange(s) to be deteted from the 
file. If a specified module is not on the files a fatal 
error is issued. 


upon or up 3? 

name of the file (or tibrary) on which the remaining 
modules are writtens olus an (optional) user name in whose 
catalog the updated file (or jiibrary) is to be placeds if 
it is not in the current user's catatoq. Whether the upon 
file is a library is determined by the format of the input 
file. If you code a file name and 4a user names they must 
be coded as a lists the first eiemeant of which is the name 
of the files and the second element the user name in whose 
catalog the file resides. If you: just code the file name 
and no user names the upon file is placed In the catafog of 
the current usere If the user name refers to another 
user's catalogs the upon file qnust already exist in that 
user's catalog. 


flock or nolock : 
these (optional) parameters deternine whether the library 
update process is interlocked against simultaneous updates; 
coding a filename for the tock parameter determines the 
name of the interlock file. Intertocking is the default 
action when the tibrary being updated is in another user'ts 
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catalog. If you dontt code either of the tock or nolock 
keyss Interlocking is controlled by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the interactions of the tokmode 
profile variabie and the lock and nolock parameters. If 
you don't code ai filename for’ the tock parameters the 
contents of profile variable intrtok is used as the 
interlock filename; if there's no such profile variables 
the name intriok is used as the Iock filename. The 
intertock file must be in the same catalog as the tibrary 
being updated. If the interlock fite cannot be founds the 
procedure aborts. 


fisting or list : 
(optional) name of fisting file on which the names of the 
modules on the new fFibrary are listed in the order in 
which they occur as well as the File from which they came. 
If you don*t code the list paraneters no "ftisting™ output 
is produced. 


msg or nomsg ? 
these (optional) keys contro? the generation of 
informative messages by this orocedure and are (fully 
described in the section entitted "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*. 
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Exampies of DEOM Usage 


sesedeom tibrary=libl module=modx uponziib2. 
REVERT. MODULES DELETED ON FILE LIB2 


This command creates a library tib2 idertical to libl except that 
module modx is deteted,. 


sesedeom files(filels userl) moz=(modae.¥odbsmodc) upzfile2 
REVERT. MODULES DELETED ON FILE FILE? 


This command creates a file file2 {is tlibrary if filel is 
library) identical to filel except that asdules hetween moda and 
modb inciusive and mode are deleted. The file {or library) filel is 
being obtained from the cataiog of userl. 
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13-3 DIOM_-_DISPLAY OBJECT MODULE INFORMATION 


DIOM DIsptays various pieces of information about Qbject 
Module(s) in an object tibrary. The format of the tist file 
produced is described in the object code utilities ERS {ARH2922). 
Parameters to DIOM are 3 


file or f or tibrary or tib : 
name of file tor tibrary) whose contents are to be 
displayeds olus an (optional) user’ name in whose catalog 
the file (or tibrary) is to be founds ff it is not in the 
current user's catalog. The specified file may or may not 
be a tibrarys but if the keyword used is Vib or Jibrarys it 
must be a library. If a file (or tibrary) name and a =user 
name is coded» they must apoear as ai tists “for 
example 3: Jtibzfoffthes wail) to get tibrary of fthe from the 
catalog of user wall. 


module or mo 2 
(optionat) module{s) or module subrange{s) about which 
information is to he dispiayete. If a subrange is 
specifieds, all modules in the subrange are displayed. 
Omission causes all modules in the file or library to be 
displayed. 


listing or tist : 
(optional) name of file on which the disolay information 
is to be written. Omission causes the information to be 
written to the job output file. 


(optional) tevel of information to he displayed. Qnty the 
options selected are in effect. Valid specifications are: 


time and date module was created 

entry point definitions of the nodule 

module header information 

external references made by the nodule 

all information printed by Ds Fs H and X (default) 


> x rm Oo 
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Exampies of DIOM Usage. 


sesediom library=tibl modulezmodx tistzistx: onsa 
REVERT. MODULES FROM FILE LIB1 DISPLAYED 


This command tists ali information about nodule modx of tibrary 
tibl on file tistx. 


sesediom filtez(filexsiosery) mo=(modae.nodbsmodc) on={dshsx) 
REVERT. MODULES FROM FILE FILEX DISPLAYED: 


This command lists date and time createds module header 
informations and external references about modules moda to modb 
inclusive and mode of fitex (may be !ibrary) on file output 
(default). The file filex is acquired fron the catalog of user 
losery. 
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1324 GOL =_ GENERATE OBJECT LIBRARY 


GOL Generates an Qbject Library» or updates an existing object 
fibrary. Aliso» several files can be combined into one. GOL 
requires that there be an input file specified either by the file 
parameter, or base parameter. 


The add» repiaces and combine parameterss specify exactiy which 
modules from the file(s) specified by the fille parameter to inctude 
on the new tibrarys while the after and before parameters controi 
the position of the new modules. Parameter’: to GOL are 3. 


file or f or fibrary or lib ;: 
(optional) tist of filename-usernane voairs describing files 
(or libraries) from which object nodules specified by the 
following three parameters are to be obtained for the new 
library. The specified filets? nay or may not be 
flibrary(s)» but if the keyword used is tib or librarys they 
must be Jlibrary(s). Each element in the tist of fille (or 
library) names can either be a single fife for tibrary) 
names of the element can itself be a tist of two elements, 
the first is the file (or ltibrary) names and the second is 
the user name in whose catalog the file (or tibrary) 
residess If onty a singte elements file tor tibrary) name 
is givens, the file tor tibrarvy) is acquired from the 
current user's catalog. 


The next three parameters (combines adds and replace) specify 
module(s) or module subrange(s} to be included on the new tibrary 
from the files specified by the file or Uttbrary parameter. Nones 
ones two or all three parameters may be specified. If none are 
specifieds ail the modutes on the files specified by the file or 
library parameter is included on the new library.’ Onty the first 
occurrence of duplicate modules are included in the new tibrary. 
As explained belows the particular paraneterts) used give you 
control over whether the given modules should exist on the base 
library(s). 


combine or co 3 
{optionat) module(s) to be incliided in the new library. 
The specified module(s) may or nay not exist on the base 
library(s). If they exists they are replaced. 


add : 
(optional) module(s) to be ADDed on the new tibrary. If a 
specified module duplicates a module already on a tibrary 
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specified by the base parameters a fatal error is issuede. 


replace or rep ; 
(optional) modufe{s) to be REPLACEd on the new tibrary. 
If a specified module does not already exist in a IJibrary 
specified by the base parameters a fatal error is issued. 


after or af or before or be : 
{optional) modute on a base library after or before which 
to position the new modules. Default position is after 
the last module on the last base tibrary.! 


base or b or basetlib or bi : 

(optional) list of filename-usernane oairs that determine a 
fist of base file(s) or Jlibrary(s) to be included in the 
new object file. Ali modules from the base files (or 
libraries) become part of the new object file except 
dupticate modules (the first occurrence of the module takes 
precedence). The specified filets) may or may not be 
fibrary(s)» but if the baselib or’ bl keyword is used to 
code the parameter» they must be !fibrary(s). Each element 
in the list of filles (or libraries) can itself be a tist of 
two elementss the first being the nane of the File (or 
library)» and the second being the nane of the user in 
whose catalog the file (or tibrary) resides. If only one 
element is specifieds the file (or ttbrary) is acquired 
from the current userts catalog. 


upon or up 3 

name of file to receive the generated object fibrarys pilus 
an (optional) user name in whose catatog the new object 
library is to be placeds if it is not in the current user's 
catalog. If you code a File name and a user names they 
must be coded as a fist of two elenentss the first of which 
is the file names and the second the user’ name. If you 
just code the file names the upon File is placed in the 
current user's catalogs If the user name refers to another 
user's catalogs the upon file nust aliteady exist in that 
user's catalog. 


lock or notock ;3 . 
these (optional) parameters deternine whether the tibrary 
update process is interlocked against simuttaneous updates; 
coding a filename for the flock oarameter’ determines the 
name of the intertock file. Interlocking is the default 
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action when the library being updated is in another’ user's 
cataloge If you don't code either of the tock or nolock 
keys» interlocking is controlled by the tokmode profile 
variable. Refer to the tntroductory sections of this 
chapter for information on the interactions of the tokmode 
profiie variable and the tock and nolock parameters. If 
you don*t code a filename for the tock: parameters the 
contents of profile variable tintrtok is used as the 
interlock filenames if there's no such oprofile variables 
the name intriok is used as the tock filename. The 
interlock file must be in the san2 catatog as the tibrary 
being updated. If the interlock: Fife cannot be founds the 
procedure aborts. 


listing or list : 


(optional) name of listing file on which the names of the 
modules on the new tibrary are tisted in the order in 
which they occur as well as the file fron which they came. 
If this parameter is not specifieds no "Fisting" output is 
produced. 


msg or nomsg : 


ipf 


these (optional) keys control: the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 


(optional) parameter specifies that the other parameters 
may be specified on a tocal file.! The parameters which 
may. be specified are: FILE» COMBINE, ADDs REPLACE» 
AFTER/BEFOREs and BASE. The paraneters are specified on 
the file the same way they are specified on the command 
line. 


Exampies of GOL Usage 


sesegot filez({coconutspaim)) listerocker uponznewlib 
REVERT. OBJECT LIBRARY GENERATED 


‘This command creates a library newlib which contains all the 
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modules from file coconut (may be tibraryss obtained from the 
catalog of user paim. Dispiay information appears on file rocker, 


sesego!l tibzinptib add=moreof rep=zsameas: blzbaselib upznewtib 
REVERT. OBJECT LIBRARY GENERATED 


This command creates a library newltb identical to tibrary 
baselib except that module sameas from library inptib replaces 
sameas and modute moreof from inptib is added at the end. Display 
information appears on file output (default). 


sesego! basez(filelsfile2sfile3)} uponznewlib. 
REVERT. OBJECT LIBRARY GENERATED 


This command creates a library newlib which is the combination of 
libraries fltels file2 and fite3s $j$al! obtained from the current 
user's catalog. OQniy the first occurrence of duplicate modules 
appears on the new Ttibrary. Display information appears on file 
output. 


sesegol (fileasfileb) coz(tea..dinnersnitecap) aftersiunch ee 
ee? basezbaselib up=nova 
REVERT. OBJECT LIBRARY GENERATED 


This command creates a library nova usi1a9 library baselib as a 
base. Moduies tea thru dinner iinctusive and nitecap from files 
fitea and fileb (may be libraries)» both obtained from the current 
user's catalogs are added after modufe ftunch. DOlsetlay information 
appears on file output. 


sesegol iIpfz=golipf tist=listf upon=new 
eDATAsGOLLPF. 
FILE=(FILEL, FILE2) 
COMBINE 2(MGD1..MOD3) eo 
MOD6 
BASE=MY BASE 
(EOR) 


This command creates a tibrary new by combining Files FILEL,FILE2: 
and the modules MOD1..MOD3 and MOD6. The base File Is MYBASE. Note 
that the parameters are obtained from GOLLPF.: 
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13.5 GOF =_ GENERATE OBJECT FILE 


GOF Generates an Qbject Eiles or updates an existing object file. 
Also» several files can be combined into onee GOF requires that 
there be an input file specified either by the file parameters or 
base parameter. 


The add» repiaces and combine parameterss specify exactly which 
modules from the file(s) specified by the fille paraneter to include 
on the new object files while the after and before parameters 
control the position of the new modules. Paraneter’s to GOF are 3: 


file or f or tibrary or fib : 

foptional) list of filename-usernane oairs. describing files 
(or tibraries) from which object modules specified by the 
following three parameters are to be obtained for the new 
object file. The specified file(s) nay or may not be 
library(s)» but if the keyword used is #!§b or Jibrarys they 
must be tfibrary({s). Each element in the tist of file (or 

 ibrary) names can either be a singte File for ftibrary) 
names of the element can itself be a fist of two elements, 
the first is the file (or fibrary) names and the second is 
the user name in whose catatsq the File (or tibrary) 
resides. If onty a single elements file (or library) name 
is givens the file (or tibrary) ts acquired from the 
current user's catalog. 


The next three parameters (combines adds and replace) specify 
moduile(s) or module subrange(s) to be Included on the new object 
file from the files specified by the file or ttibrary parameter. 
Nones ones two or all three parameters nay be soecified. If none 
are specitfieds, all the modules on the files soecified by the file 
or tibrary parameter is included on the new object file. Onty the 
first occurrence of duplicate modules are inectuded in the new 
object file. As explained belows the particular parameter(s) used 
give you control over whether the given nodules should exist on 
the base tibrary(s). 


combine or co 3 
(optional) module(s) to be inctuded in the new object 
file. The specified modute{s) nay or may not exist on the 
base fibraryi{s). If they exists they are replaced. 


add 3 
(optional) modute(s) to be ADNed on the new object file. 
If a specified module duplicates a module already on a 
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replace 


after o 


base or 


upon or 


lock or 


library specified by the base parameter, a fatal error is 
issued. 


or rep 2. 

(optional) module{s) to be REPLACEd on the new object 
file. If a specified module does: not already exist in a 
fibrary specified by the base varaneters a fatal error is 
issued. 


r af or before or be : 
(optional) moduie on a base tibrary after’ or before which 
to position the new modules. Default vasition is after 
the last module on the Jast base fibrary.: 


b or baselib or bf : 

{optional) list of filename-usernane oairs that determine a 
fist of base file(s) or tibrary(s) to be included in the 
new object file. Ali modules Fron the base files (lor 
libraries) become part of the new object file except 
duplicate modules (the first occurrenca of the module takes 
precedence). The specified fitels) may or may not be 
libraryis)» but if the baselib or bi keyword is used to 
code the parameters they must be ltibrary(s). Each element 
in the list of Files (or Jibraries) can itself be a tist of 
two elementss the first being the name of the File (or 
library)» and the second being the name of the user in 
whose catalog the file (or library) resides. If onty one 
element is specifieds the file for titrary) is acquired 
from the current user's catalog. 


up 3 

name of file to receive the generated object files plus an 
(optional) user name in whose catalog the new object file 
jis to be placeds if it is .r0t =%Iin the current user's 
catalog. If you code a file name and a user names they 
must be coded as a list of two elewentss the first of which 
is the file names and the second the user name. If you 
just code the file names the upon file is placed in the 
current user's catalog. If the user name refers to another 
user's catalogs the upon file gust already exist in that 
user's catalog. 


nolock : 
these (optional) parameters deternine whether the Iibrary 
update process is interlocked against simus taneous updates}; 
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coding a filename for the fock parameter’ determines the 
name of the interlock file. Interlocking is the default 
action when the tibrary being updated is in another users 
catalog. If you. don't code either of the tock or notlock 
keys» interlocking is controtied by the tokmode profile 
variable. Refer to the introductory sections of this 
chapter for information on the Interactions of the tokmode 
profile variable and the flock and notfock parameters. If 
you don't code a filename for the fock parameters the 
contents of profite variable intrtok is used as the 
intertock filename; if there's no such orofile variabte»s 
the name intriok is used as the tock filename. The 
interlock file must be in the sane catalog as the fibrary 
being updated. If the interlock fide cannot be Founds the 
procedure aborts. 


fisting or list : 


Coptional) name of listing file on which the names of the 
names of the modules on the new Jibrary are tisted in the 
order in which they occur as well! as the File from which 
they came. If this parameter is not specifieds no 
"listing”™ output is produced. 


mSg or nomsg : 


ipf 


these {optional) keys control the generation of 
informative messages by this orocedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES*. 


(optional) parameter specifies that the other parameters 
may be specified on a local file, The parameters wheih 
may be specified are: FILEs COMBINE, ADD» REPLACEs. 
AFTER/BEFOREs and BASE. The parameters are specified on 
the file the same way they are specified on the command 
line. 


Examples of GOF Usage 


ses.gof filez((filexsusxds(fileysusy)) tistetistx upenenfile 
REVERT. OBJECT FILE GENERATED 


This command creates an object file newfile which contains all 
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the modules from the object files filex (obtained from the catalog 
of usx) and fitey (obtained from the catafog of usy).» File filex 
and filey can in fact be Jlibrary(s). Display information appears on 
file tistx. 


Sesegof tibzinplib add=modl repzmod2 bzbaselib upe(nfilesnusr ) 
*. LOCKING NEWFILE VIA INTRLOK 

* NEWFILE LOCKED 

* NEWFILE UNLOCKED 

REVERT. OBJECT FILE GENERATED 


This command creates an object File nfite identical to library 
baselib except that module mod2 from iibrary tinplth reptaces mod2 
and module modl from itnplib is added at the end. Note that file 
nfile is specified as being in the cataiog of nusrs so the object 
library update is automatically interlocked. Display information 
appears on file output (default). 


sesegof basez=(filelsfile2sfile3) uponztatest: 
REVERT. OBJECT FILE GENERATED 


This command creates an object file tatest- which is the 
combination of tlibraries filel» file2 and fite3.: Onty the first 
occurrence of dupticate modules appears on the new library. Display 
information appears on file output. 


ses.egof (fileasfiteb) co=(moda.emodbsvodc) after=modx ee 
eo? basez((baselibsolduser)) upznewobjf 
REVERT. OBJECT FILE GENERATED 


This command creates an object file newobjf using Jibrary baselib 
{obtained from the catalog of olduser) as a base. Modules moda thru 
modb inclusives and modes from files fitea and fileb (may be 
libraries) are added after module modx. Disolay information appears 
on file output. 


sesegof Ipf=golipf fistztistf upon=znew 
eDATAsGOLLPF. 
FILE=(FILELSFILE2) 
COMBINE=(MOD1 «2 M0D3) eo 
MOD6 
BASE=MYBASE 
(EDR) 


This command creates a file NEW which is a combination of FILE1 and 
FILE2 and the modufes MOD1 .«. MGD3 and “9D6. The base file is 
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MYBASE.» Note that the parameters are obtained Fron GOLLPF. 
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13-6 QBULIST =_LIST_COC OBJECT TEAT 


The action taken by OBJLIST Is determined by the DEBUG parameter. 
GBILIST wiil either print out COC object text in a readable form or 
produce a symbol table file for use with the CYRE2 180 simulator. 
Parameters to OBJLIST are ; 


i or f 3 
{optional) name of Input Eile which is to have its contents 
listed out. If you don*t code the #: parameters, QOBJLIST 
assumes the object text is on file Igo. 


0 2 
(optional) name of file to receive the Jutput from OBJLIST. 
If you don't code the o parameters the output appears on 
fiie output. 

debug : 


(optional) key determines whether JBILIST prints CDC object 
text in a readable form or produces a synbo!l table file. 
If you code the debug key» OBJLIST oroduces a symbo! table 
File. If you faii to code the debug keys ORJLIST produces 
a readable listing of CBC object text,! 


Exampies of OBJLIST Usage 


seseobjiist oztisting 
REVERT. END OGBJLIST LGO =—-> LISTING 


seseobjlist izbinar ys o=prinfy! 
REVERT. END OBJLIST BINARY => PRINFYL 
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14.0 SOURCE CODE UTILITY. ON_NOS_1790 


SES provides a series of procedures for accass to the NOS 170 
prototype implementation of the Source Codes Jtility. The procedures 
currently available in this category are: 


SCU Acquire the executable binary for SCU. 


SOLO Run the SCU editor in stand alone noda,. 


SCUCOMP Generate an SCU modification for a deck», 


EDSCY Edit a deck from an SCU tibrary. 
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14.1 SCU_-_ ACQUIRE EXECUTABLE BINARY _EOR StU 


SCU acquires the executable binary for the Source Code Utility 
and copies it to a local file named StJ. In response to calling 
this procedure the user may be sent a short nessage warning him that 
a change has been introduced and that there is additional 
information available through the STATUS facility.’ There are no 
parameters for the SCU procedure. 


The tibrary CYBCCMN or CYBICMN which contain dectarations for 
interfaces supported by the SES group may be arcessed in the form of 
SCU source tibraries through the use of the GETCOMN procedure. 
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1462 30L0_-_STAND_ALONE SCU_ EDITOR 


SOLO is a stand alone version of the SCJ editors that can be used 
to edit any text file. <A delay will be encountered when entering 
and exiting this editor because a temporary !ttbrary is created on 
entry from which the text file is extracted on exit. Parameters to 
$OLO are 3 


base or ba : 
{optional) name of text file to be edited. If you dontt 
code the base parameter, SOLO uses a tocal File named base. 


result or r 3 
{optional) name of file to receive the resuit of the 
editing session (SOLO doesntts by defaults write the edited 
file back over the text input fila specified by the base 
parameter). If you don't code the result parameters SOLO 
writes the result on a local file named resuit. 


input or f 3 
(optional) name of input file Fron «hich SGLO reads 
commands. If you don't code the input: parameters commands 
are read from input. 


list or f 3: 
{optional} name of file on which the editor dispiays are 
written. If you don't code the ttist paraneter, SOLD writes 
its displays to file output. 
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14.3 ICUCOMP =_ GENERATE SCU CORRECTION SET 


SCUCOMP compares an “old™ version of an SCU deck (obtained from 
an SCU source library) with a "new" version of the same deck 
(obtained from a “source” file). The "source”™ Fite must have 
neither tine identifiers nor deck directives in it. The output of 
SCUCOMP is a file of SCU EDITor commands that transform the "oid" 
version of the deck into the "new" version.’ 


You can sefect a character to be used as the value of the UNTIL 
parameter on SCU EDITor INSERT and REPLACE commands. The default 
character is the hyphen. If any lines of insertion or replacement 
text end in the "text delimiter" character, they are followed on the 
edit commands file with a tine that indicates: the problems and the 
NOS job control register EFG is set to a non-zero vatue; otherwise 
EFG is set to zeroe Parameters to SCUCOMP are : 


name or na : 
NAME of an SCU deck against which the correction set are 
gener ated. 


source or s 3 
name of a source file containing a nodified version of the 
deck. 


name of ae fite to which SCU editor commands are to be 
written. 


base or ba : 
{optional) name of an SCU source tibrary containing the 
Y“unmodified™" version of the SCU deck with which the source 
file are compared. If you don't code this parameters 
SCUCOMP attempts to access a fil2 naned base. 


{optional) User Name in whose catatog the source library 
specified by base is to be found.’ 


{optional) singte character value which defines the 
Terminating Delimiter to be used on text Insertion commands 
generated by SCUCOMP. The vatue of td may be given as any 
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singte characters or as a positive inteaer in the range 
Lleel27- If you don't code the td parameter, SCUCOMP uses 
the hyphen - as the default character. 


ts or ignorts : 
These (optional) keys specify whether or not to JGNORe 
Leading Spaces on lines being conpared. The default 
action is to recognise leading spaces {the Is option). If 
you code the ignoris key SCUCOMP ignores leading spaces on 
text tines. 


Example of SCUCOMP Usage 


sesescucomp *scem$editor help _command* formed oi! 
eczmodform bassi0619 


This example of SCUCGMP compares formatted source statements on 
file FORMED with the SCU deck SCMSEDITOR_HELP_COMMAND from the 
source ftibdrary on File §10619 to build an SCU modification for the 
deck on fiie MODFORM. In this case lines differing by leading 
spaces were recognised as changed. 
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14.4 EDSCU = EDIT _A_DECK EROM_AN_SCU_LIBRA2Y 


EDSCU provides the user with a convenient way to make 
modifications to decks from an SCU library without having to 
directly use the SCU editor. The user may use FSEs XEDITs EDITs ofr 
EDT depending on their preference. Parameters to EDSCU are : 


Na or name 3 
(optional) name of deck to be edited. If you don*t code 
this parameters EDSCU will prompt you for it unitess you 
coded the end key and are in SCU.S290UP mode (see the group 
key below). 


ba or base 3:3 

{optional) name of the base where the deck to he edited 
can be found. The base paraneter should only be coded 
when you aren't in SCU.GRDUP mode. If you arentt in 
SCU.GROUP mode and haven't coded this’ parameters EDSCU 
uses the value of the profile variable secubases and if 
there's no such variabte defined in your profile then 
EDSCU wild prompt you for the base nane. 


nb or newbase ; , 

(optional) name of the new base where hbase is to be 
rewritten after the deck changes are comoltete. ODefault is 
to write back over the base name sovacified by the base 
parameter. EDSCU will not pronot you for this parameter 
so to change it you must code it on the calito EDSCU. 
This parameter can be set or changed at any time. Last 
value coded is used when the end key Its coded. 


mod or modification : 

Coptional) modification name to us2 when your editing 
changes are supptied to the SCJ editor. If you arentt in 
SCUeGROUP mode and haven't coded this ovoarameters EDSCU 
will prompt you for ite You nust code this parameter on 
the call to EDSCU to change the value while in SCU.GROUP 
mode. This parameter can be set or changed at any time. 
Last value coded is used on subsequent calls to this proc 
until the end key is coded. 


e or editor : 
{optional) name of the editor’ you wish to use. If you. 
don*t code this parameters EDSCJ uses the vatue of the 
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1420 SOURCE CODE UTILITY ON NOS 170 
1464 EDSCU - EDIT A DECK FROM AN SCU LIBRARY 


profite variable editors and if there's no such variable 
defined in your profile EDSCU will use FSE as the editor. 
EDSCU will not prompt you for this value. This parameter 
can be set or changed at any time. The ltast value coded 
is used on subsequent calits to this proc until the end key 
is coded. 


g or group : 


end 


(optional) key initiating SCU.G235P node. The use of this 
parameter is recommended if your. changes will be 
associated with more than one nodification name or your 
changes wil! occur in more than one decke This parameter 
should be coded only when you arentt already in SCU.GROUP 
mode. EDSCU assumes you are in SCY.GROU® mode if either 
files Z2ZZZZGF or SESSCCG are focal. ENSSY will not prompt 
you. for this value. 


{optional) key terminating SCU.G27I3°9 node. EDSCU will not 
erompt you for this value. 


An Exampie of EDSCU Usage 


seseedscu g 

ENTER DECK NAME 

ddump 

ENTER BASE NAME 

testba 

ENTER MODIFICATION NAME 

xyzmod 

* BEGINNING EDSCU ON DDUMP DF TESTBA 


? 
? 
? 


* BEGINNING GROUP FOR TESTBA 
* XEDIT AVAILABLE 


2? 
? 
2? 


j F 
C HELLO THERE ONE AND ALL 


e 


ZQPQDXN IS A LOCAL FILE 

* GENERATING CHANGES FOR DDUMP 

* INSERTING CHANGES TO DDUMP 

** E SC 8004: Continue specified for unknown nodification 
* MODIFICATION XYZMOD ADDED TO DDUMP 

* DECK DDUMP EDIT COMPLETE 
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* ENTER *SES.~EDSCU*.TO EDIT NEXT DECK: 

* ENTER *SES.EDSCU END* IF FINISHED 

S$REVERT. 

seseedscu end 

* ENDING *EDSCU* EDIT SESSION TESTBA --> TESTBA. 
SREVERT. 


Please note that the error message (3994) generated in this 
example can be expected if the modification nane used is a brand new 
ONe » 
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15.0 SOURCE TEXT PREPROCESSORS 


The utilities described in this section comorise a general set of 
reformatting facilities for source text. They are described briefly 
heres and more detailed descriptions follow, 


CYBFORM a source code formatter for CYBIL.: 
ISWLERM a source code formatter for ISWL. 
PSEUDO text preprocessor that can generate repetitive 


sequences of text. 


Ne 


F5FORM formats Fortran 5 source texts 


PASTOCYB runs the PASCAL to CYBIL source code transiator. 
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15.1 CYBFORM =_CYBIL SOURCE TEXT REFORMAITER 


CYBFORM is a source code reformatter for CY8IL»s such that program 
readability and consistency of presentation are enhanced. The 
operation of this procedure differs from that described in the 
CYBFORM ERS in that this procedure rewinds both the input and output 
files before and after the reformatting operation. Note that. 
CYBFORM can handite multi record files.» Parameters to CYBFORM are : 


ior f 3 
name of Input File containing the CYBIL source text to be 
reformatted, 


e@ 
6 


(optional) name of file to reseive the Output from 
CYBFORM. If you don't code the oo parameters CYBFORM 
places the output on the file specified by the i 
parameter. 
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1542 TSWLERMN =-_ISWi SOURCE TEXT REFORMAITER 


ISWLFRM reformats ISWL source codes such that orogram readability 
and consistency of presentation are enhanced.» Parameters to ISWLERM 
are 3 


i or f 3 
name of Input File containing the ISWL source text to be 
reformatted. 


{optional) name of file to receive the Qutput from 
ISWLFRM. If you don't code the o parameters ISWLERM 
places the output on the file specified by the i 
parameter, 


Summary of Eormatting Directives 


Directives are given to the ISWL formatter’ by embedding 
certain comment toggle options in the inout ISWL source code ? 


AR: OE AO OT I I eS BEE Re: ESD Se S ceotemdanal bo Ge Wie ae ae OD A ee ED ee a a ee ee ED Oe OD i  -0  -  e  ee > 


a 
% 
§ 
8 
a 
a 
s 
a 


oe aw oe pb ow ph Oe Oe we ow 


“EPpy $ Select comment formatting. 4 
"g¢p—" 3; Turn off comment formatting. ; 
"SPR" ' Discard existing line numberss if anys and generate 3} 
} new fine numbers. : 
; "$PN* ; Discard existing tine numberss if anys and do not } 
H ; generate new tine numbers. ; 
; "gps" + Preserve existing line number's. H 
pe ee eo oe ee ew ee case he ame ee ce ee ene ae ce Same He ED ND SOU EY GND DEN EO SD DSO ED ED SED A ND OD AA ED Se ND io ae ae <Any aD ean ete aD ate ee ee + 
: "$pB™ : Preserve aa stine blank hiwess H 
> ee we oe we ee wor } oe ee en ee ee ee ee oe oe en ee ne a PE Tb TD - A ib > a a> ah ae a a RE iE) I ER ED + 
H wepy" +; Capitalize ISWL keywords. H 
ee www we we www CO ee ee ee ee ee ee ee ee ee + 
"SM<n>™" | ISWL Margin chop. Sacwatter® wraps fine aeauna at 
3 


a & 
3 2 
H : N-1l character position. § 
+ + 


Defautt selections 3: "$M72" "$PS* "Ep—" 


Note : ISWLFRM assumes a syntactically correct ISWL program. 
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Syntax errors may cause undesired results on the output file. 
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15.3 PSEUDD _=-_RUN PSEUDO PREPROCESSOR 


PSEUDO is a text preprocessor which enables parameterized 
replication of selected portions of a text> file. The parameters to 
this procedure are: 


ior f : 
name of the Input File containing the text to be processed 
by PSEUDO. 


{optional) name of file to receive the Output from 
PSEUDO. If you don't code the o8 =darameters, PSEUDO 
directs the output to the file specified by the i 
parameter. 


mi: 
(optional) name of file to receive the secondary output 
(Messages) from PSEUDO. If you don*t code the am 
parameters PSEUDD places the Messages outout (if any) on a 
file called MSGS. 

op : 


(optional) name of the File to receive the statistics (and 
any error messages) from the run. Tf you don't code the 
op parameters, PSEUDO writes this information to file 
QUTPUT. 
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15.4 ESEORM_=_ FORTRAN 2 SOURCE TEXT REFORMATIER 


FSFORM reformats FORTRAN-5 source text to reffect the nesting 
levels of IF-THEN-ELSE blocks and 00 toops.' Parameters are : 


door f : 
name of Input Eile containing the FINS source text to be 
reformatted by FOFORM. 


foptional) name of file to receiv2a the Qutput from F5SFORM. 
If you don't code the o paraneters F5SFORM places the 
resultant formatted text on the fiie specified by the i 
parameter. 


Examples of FSFORM Usage 


ses.f5form .izmessys ozlovely 
REVERT. END FSFORM MESSY => LOVELY 


sesef5form modern 
REVERT. END FSFORM MODERN 
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1525 PASTOCYBR = PASCAL _TO_CYBIL TRANSLATOR 


PASTQCYB runs the PASCAL to CYBIL source code transtator. This 
translator is based on the University of Yinnesota PASCAL compiler. 
It performs syntax checking on the source Input and witt transtate 
incomplete decks» although compiete source input files produce the 
best results. Note that this transtator may not work for all of the 
many existing dialects of PASCAL. 


The procedure is arranged so that it will not abort. If source 
code conversion errors are encountereds the NOS Job Control Register 
called EFG is set to a non-zero value upon exiting the procedure. 
Parameters to the PASTOCYB procedure are : 


ior f : 
{required) name of PASCAL source inout file, 


o 
(optional) name of the output File to receive the CYBIL 
source code produced by the transtator. If you don't code 
the 0 parameters a file named CY8SFILE Is used, 

io: 

(optional) name of the file to receive the tisting 
produced from the transtation process. If you don*t code 
the 1 parameter, a file named LISTING wil! be used. 

mi: 


{optional) this parameter specifies the maximum tine 
fength of PASCAL source to be transtated.: The default for 
this parameter is 120 characters. 


Example of PASTOCYB Usage 


sesepastocyb izpsource ozcsource 


This example shows PASTOCYB transtatiyg the PASCAL source file 
psource into a CYBIL source file named csourtee The listing 
_produced defaults to the file named LISTING. 
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16.0 SES COMMUNICATIONS 


16.0 SES_ COMMUNICATIONS 


User_to Usec Communications 


SES provides a communication system such that users can send 
filsss between sitess and can also MAIL nessag2s to each other. To 
receive maiis, you need a MAILBOX in your catatog. A MAILBOX is 
created by using the SES NEWMAIL procadure. When you create a 
PROFILE using the BuilD PROFILE (BLDPROF) orocedure mentioned in the 
introductions a MAILBOX is also created, 


SEND send files between Sites with NOS development 
machines. 


MAIL send mail to other userse 


GETMAIL displays the mail from your nafithbox at your terminals 
or aiternativelys the mail can be placed in a file for 
subsequent printing or whatever’: 


NEWMAIL creates a new mailbox. You also use NEWMAIL when you 
want to "clear out™ the contents of the maitbox. 


ANYMAIL telis you how many items of nail are in your mailbox. 

WHOMAIL tells you who sent the items of mail that are in your 
maiibox. 

SAVMAIL Saves the contents of your mailbox. 

CHKMAIL @ procedure SEGMENT that you can INCLUDE into your 


PROFILE» so that if there is any nail in your mailboxs 
you get a message every time vou use SES. 


FEEDBACK SES user feedback mechanism. 
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The MAIL procedure puts a line at the start of every message that 
shows you the user name (and possibly the real name) of the person 
who sent you the messagee It's possibie to have your name (in 
characters) included in this by defining a myname PROFILE variable 
as a strings as foliows 3. 


\ myname = *Ethel Snerge? 


Now every time you send a mailbox message to somebody via the 
MAIL procedures the header of the message in the destination mailbox 
reads 3 


FROM USER ES91 ( Ethel Snerge ) ON NOV 199 1977 AT 9333 AM 


MAIL also provides the facility to equate oensotes* real names 
with their user namess so that you car send nail tos says fred» 
instead of fjc0795 or some other cryptic machine oriented name. You 
can do this by putting statements like this: in your’ profile ; 


IF PROCNAM = *MAIL* THEN 
fred = §FJC0795? 
bill = *"wAHOO001? 
andy = *AJL6655? 

IFEND 


OP SS F 


This series of SES directives in your profile defines the names 
givens but only when the procedure being used is MAIL. Nows you can 
send mail tike this 3 


sesemail ietters to (freds bifls andy?) 


Note that when you are using equated nanes of this type you must 
use the to keyword on the MAIL procedure instead of the un keyword. 
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Remote Mainframe Communications 


SES provides a set of procedures to subnit jobs and manipulate 
permanent files on remote tinked mainfranes. Here is a summary of 
the remote access procedures 3 


SUBMIT SUBMIIs a file to be processed as a batch jeb on the 
specified mainframe. 


GETPF GETS a Permanent Eile (direct or indirect) from a remote 
mainframe to a permanent file (direct) on the focal 
mainframe. 


SENDPF SENDs a copy of a Permanent Elte (direct or indirect) to 
a direct permanent file on a renote nainframe. 


CHANGPF CHANGes parameters of a Permanent Elle on aeremote 
mainframe. 


PURGPF PURGES {removes) a Permanent Eile from aeoeremote 
mainframes 


PERMPF PERMits another user access to 4a Permanent Eile. 


CATPF disptays CALIIist information about Permanent Eiiles 
existing on the remote mainfranea. 


DISPOSE PRINTs a fite from the local nainfrane on a printer at 
the remote mainframe. 
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Each mainframe has been assigned a site tdentifier. These site 
identifiers (located in Arden Hilts) are ?. 


MO1l - CY176 — S/N 101 

M42 =~ CY760 =- S/N 420 

M10 - CY73 - S/N 101 

MO2 - CY835 - S/N 002 - $3 
M04 - CY835 - S/N 104 = $2 
MO5 =~ CY174 - S/N 805 

MO7 ~- CY875 - S/N 907 


Note ; As additional systems are added to the networks they are 
assigned a site identifier. 


In addition to the site-ids each user nust have a valid user 
names passwords charge number and project nunber for the target 
machine. These may be coded into your PROFILE. The PROFILE 
variables are created by concatenating the site-id with 'fam' for 
family names ‘use’ for user names ‘past for passwords 'fchat for 
charges and ‘pro’ for project. Users may have PROFILE variables for 
each remote mainframe they are vatidated to run Jobs on. In 
interactive mode» the remote tink procs requests the family names 
user names passwords charges and project variables if they are not 
in your PROFILE. 


Note : that in batch mode» the variable nust exist in your PROFILE> 
ac the job aborts. 


EXAMPLE : The variables needed for a S/N 420 user to run jobs on 
the Arden Hills 101 would be 3; 


PROFILE 

\ MOLUSE = "your 101 user name? 

\ MOLPAS = "your 101 password? 

\ MOLCHA = *your 101 charge number 
\ MOLPRO = "your 101 project number! 
\ MOLFAM = ‘your 101 family name? 


If the value for a remote site charge vparameter is set to a null 
string (for exampie M42CHA = '1), the remote tink oprocedures omit 
the CHARGE statement in the job control statement stream that is 
sent to the remote mainframe for execution.’ 


If a remote site family name is seat to anull string (for example 
MOLFAM = ‘'%*)y the family parameter isrtt specified on the USER 
Statement. 
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16.1 JEND.=_IRANSMIT_FILES BETWEEN _NOS_SITEY. 


SEND is a facility to transmit files between NOS sites. 


When you SEND a file to a remote users a cooy of the file is 
placed in the special catalog C8E at the renote site. This copy of 
the file is a DIRECT access file which is defined with ai UNTQUE 
Namee The receiver is given WRITE pernission on the files and a 
message is mailed to the receiver to inforn him of the real name of 
the file you sents and the unique name assigned to the file in the 
C8E catalog. The receiver should copy the file to his own catalog,» 
and then PURGE the file from the CBE catalog. Note that if the 
receiver doesn't have a mailboxs he won't be inforned that the file 
is there. Parameters to SEND are ! 


file or f or i 3 
name of the file to be sent to the remote user, 


un or to : 
User Name of the user TO whom the file ts to be sente 


at or in 3 
Identifier of the site (7 characters or tess) AT or IN 
which the receiver resides. 
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Example of SEND Usage 


sesesend binfile to hm00612 at svt452 
REVERT. END SEND BINFILE -> HMO0612. AT SVL 


sesesend regards to rdp at arhl01 
REVERT. END SEND REGARDS => RDP AT ARH 


The two examples show SEND used with all its oarameters. One 
sender is assumed to be in Arden Hilts. (424101) sending to someone 
in Sunnyvale (SVL452)»5 and the other exannpi2 shows the reverse 
situation. 


Example of MAIL messages received from SEND 


When a remote user sends you Files» vou reaceive mail messages 
something like the following 3: 


sesegetmaii | 

* MAILBOX CONTENTS 

* 

FROM USER CSE ( CYBER 18 RECEIVER ) ON JAN 145 1980 AT 12333 PM 


FILE ASORT=ZQ06B52/UN=C8E FROM REF (CRODNEY FOTHERINGAY) IS AVAILABLE 


FROM USER CBE ( CYBER 18 RECEIVER ) ON JAN 155 1980 AT 12345 PM 
FILE GOF*ZQZWBXG/UN=C 8E FROM ERP (EARNEST POSTLETHWATTE) IS AVAILABLE 
REVERT « END GETMAIL 


Now you ATTACH the files from the CBE catalogs copy them to your 


own catalogs and finally purge them from the C8E catalog (and please 
remember the last step). 


. 16-7 

CDC - SOFTWARE ENGINEERING SERVICES 
18 December 84 

SES User*s Handbook REV: 4A 

16.0 SES COMMUNICATIONS 

16.2 MAIL —- SEND MAIL TOD OTHER USERS 


A AN AARNE AUN Semel OE “ANN AN NEN. “AD ANS ATS EY EN AO A HOD ED ND A “ND TD SNP EN NS OD ED A ND A T-ASE OD ED ED SE AOD AE EN AN OD OE NN AE FD “AE OD HN ED 


1662 MAIL _=_SEND_ MAIL_TO_ OTHER USERS 


MAIL is the procedure to send mail’ to other users! mailtbox(s). 
Parameters to MAIL are: 


i or f 3 
(optional) name of Input File containina the mail to be 
transmitted to the mailboxe(s). IF vou dontt code the i 
parameter, MAIL takes the message fron File INPUT» so that 
if you're at the terminals it pronots for’ the messages 


un or to : 
list of User Names to whom the naif is to be sent TO. 


at or in: 
(optional) identifier of the site (nachine identifier) AT 
which the addressees reside. All addressees in the iist 
(if more than one) must be at the sane site. If you dontt 
code the at parameters mail is sent to users on the machine 
you're running one 


MAIL Addressees who. do not have a MAILBOX 


It may happen that one or more people to whon you're sending mail 
don't have a MAILBOX. In this cases If the source of mail is a 
terminal file (such as INPUT)» MAIL saves the message you so 
faboriously typed in on a unique named files and issues a message to 
that effect. If the mail’ message was on a permanent files of course 
it is left tocal anyway. 
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Exampie of MAIL Usage 


sesemaiil un#j303 

? Alex 32 

? I*ve made the modifications to SESPROAC and 
2? reptaced it on SESLNAM. 


? 
REVERT. END MAIL INPUT <-> J303 


sesemail missifs to (shermans bobs jia) at 01 
REVERT. END MAIL MISSIFS => SHERMAN..JIM 
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16-3 GETMAIL -~_ DISPLAY MAIL FROM MAILBOX 


GETMAIL displays the contents of your naitbox on a files output 
{the terminal if youfre an interactive user) by defauit. Parameters 
to GETMAIL are 3: 


o or output 3 
(optional) name of file to recatlve the Qutput from 
GETMAIL. If you dontft code the o parameters GETMAIL 
displays the mail on file OUTPUT.,: 


seq 3 
if you code this (optional) «keys GETMAIL writes the 
contents of your mailbox with each line SEQuenced (the 
sequence number wittl be on the teft end of the tines). 
This feature is useful» for examples for extracting 
information from your mailtbox via the SELECT procedure 
(desribed in another section of this document). 


at or from 3: 
foptional) identifier of the site (machine identifier) 
from which mail is to be read». If vou dontt code this 
parameters GETMAIL reads maii® fron the mailbox on the 
mainframe you'tre running on. 


user or un or wu 3 
(optional) user name whose mailbox is to be read. This 
parameter atlows you to read mail’ fin mailboxes under other 
user names if you are authorized to read them. If you 
don?t code the user parameters your user name is assumed. 


Example of GETMAIL Usage 


sesegetmai i 
MAILBOX CONTENTS 


* 
FROM USER HNO3 (Valery Vitriofix) ON NOV 49 77 AT 4333 PM 
Sam 3 . 
New version of program now available on the 
project program librarye escoosVal 
REVERT. END GETMAIL 
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16.4 NEWMAIL =-_CREATE_A_NEW MAILBOX /¢ CLEAQ_EXTSTING MAILBOX 


NEWMAIL creates a new mailbox if one doesntt already exist in 
your catalog. If a mailbox already extsts» NEWMAIL deletes any 
items previously examined via GETMAIL. There are no parameters to 
NEWMAILs you simply code : 


sesenewmai i 


Also see the tntroduction to the Handbook for the description of 
the BuilD PROFile (BLDPROF) procedures which in addition to creating 
a profile for yous creates your mailbox as part of setting up your 
initial SES environment. 
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16.5 ANYMALL =~ COUNT NUMBER _OF ITEMS IN MAILBOX 


ANYMAIL informs you of how many items there are tn your wmatlboxs 
Parameters to ANYMAIL are ? 


output or o ? 
(optional) name of the file to which ANYMAIL writes it?s 
output. If you don't code the output parameters, ANYMAIL 
writes it's output on File QUTPJT.: 


at or on 3; 
{optional) identifier of the site (machine identifier) at 
which mail is to be counted. If vou don't code the at 
parameter, ANYMAIL counts itens =in vour maitbox on the 
mainframe you're running on. 


user or un or wn 3: 
(optional) user name whose naitbox items are to be 
counted. This parameter allows you to check for mail in 
other mailboxes you are authorized to read. If you dontt 
code the user parameters your user name is assumed. 


Examples of ANYMAIL Jsage 


seseanymai t 

4 LETTER(S) IN MAILBOX 
REVERT. END ANYMAIL 
sesegetmail storage 
REVERT. END GETMAIL 
sesenewmai | 
REVERT. END NEWMATIL 
seseanymai li 
NO MAIL TODAY 
REVERT END ANYMAIL 


The example shows ANYMAIL stating that there are four fetters in 
your mailbox. After doing a GETMAIL to place the mnailbox contents 
on fite storages and a NEWMAIL to clear out vour maiftboxs the second 
call to ANYMAIL informs you that there is 19 mall in the mailbox. 
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16.6 WHOMAIL = DISPLAY _LIST_OF USERS WHO YAVE_SENT MAIL 


WHOMAIL displays the fist of users WHO have sent MAIL to your 
mailbox since the tast time you. did a VEWMAIL. The user name of 
each user is displayed along with the date and time that the message 
was sent. There are no parameters to WHOMAIL.. 


Example of WHOMAIL Usage 


sesewhomai i 

FROM USER AEN (Atfred Es Neumann) ON NOW 25° 79 AT 5310 PM 
FROM USER FDR ON DEC Lis 79 AT 4232 AM 

FROM USER JEK ON JAN 25 80 AT 3210 PM 

FROM USER JXH (Jack Horner) ON FEB 55 80 AT 8215 AM 
REVERT. END WHOMAIL 


This example shows the results when there are 4 messages in your 
mailbox at the time WHOMAIL is used. If there are no messagess the 
oniy output from WHOMAIL is the ending message (REVERT. END 
WHOMAIL). 
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16.7 SAVMAIL =_ SAVE MAILBOX 


SAVMAIL saves your mailbox as a text record on a multirecords 
direct access» permanent file called OLDYAIL. If there's no file 
calijed OLDMAIL in your catalogs SAVMAIL creates onee Parameters to 
SAVMAIL are: 


titte or t : 
(optional) seven (7) character nane of the text record on 
BDLDMAIL to contain the current contents of your mailbox. 
If you dontft code the title paraneters SAVMAIL creates a 
name beginning with the tetter “4 and followed by the 
current date in the form mmddyy. 


Examples of SAVMAIL Usage 


sesesavmail title=xpsr421 
REVERT. END SAVMAIL MAILBOX =-—> OLOMAIL 


This example shows the case where it was desired that the message 
in the maiibox be saved under an identifiabte name like aie PSR 
numbers 


sesesavmail 
REVERT. END SAVMAILC MAILBOX => OLDMAIL 


If this exampte were run on April’ 22s 1979s vour maiftbox would be 
saved as record M042279 on OLDMAIL. 


Note : see the Chapter on LIBRARY MANAGEMENT» especially the 
GETMEM(S) procedures for some words on ttow to handle mufti record 
files. 
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16.8 CHKMAIL =_CHECK YOUR MAILBOX 


CHKMAIL is not actually an SES procedure that you can use via a 
sesechkmail statements rather it is an INCLUDE Fillee The way to use 
it is to INCLUDE it into your PROFILEs with an SES directive like 
this in your PROFILE: 


\ INCLUDE "CHKMAIL*»s L=UNIQUE(NAME)» LPFN=SESLNAMs UN=SESUNAM 


This SES directive fine arranges that every tine you use any SES 
procedure (with the exception of the MAIL procedures}, the CHKMAIL 
segment checks your MAILBOX for messages» and if there are anys it 
Issues a message to tell you to look at your mail. 
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16.9 FEEDBACK =_SES_USER_ FEEDBACK MECHANISY 


FEEDBACK alftows you to record a comment: or suggestion on the 
usability of SES proceduress or anything vou want. The comments 
will be collected and reviewed for inplementation by the SES 
project. (The SES project will) collect the comments directty on S/N 
101 in Arden Hilts. The SES tools installer at other sites have 
been requested to do the same and forward then to the SES project. 
You should confirm that this will be done ortor to using FEEDBACK.) 


The comment may be entered interactivety when FEEDBACK is 
exe cuteds or given as a previousty created File.’ The times date and 
your user name are recorded with each comnent. Parameters are : 


ior f or file ;: 
(optional) name of input file containing the comment to be 
transmitted. If you don't code this oarameters FEEDBACK 
takes the message from file INPUT,» so that if you"re at the 
terminal, it prompts for the messages 


Exampies of FEEDBACK Jsage 


sesefeedback file=zcomment 
REVERT. END FEEDBACK 


This examplte shows use of FEEDBACK with the opreviousty created 
file comment. 


ses. feedback 

? The GIBRISH procedure HELP documentation doesn*t inctude 
? BATCH params. 

2 (CR) 

REVERT. END FEEDBACK 


This example shows use of FEEDBACK with the comnent being entered 
interactively. 
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16.10 QUBMIT_ = SUBMIT_A_J08_ TO BE PROCESSEQ_AT_A_REMOTE_SITE 


SUBMIT provides a method for running a job on a remote mainframe. 
A user provided job file is processed as a hatch job on the 
specified mainframe. A user job for 170 mode execution is 
responsible for getting its output sent to any site other than the 
one the job runs on. This can be done by coding an SES-DISPOSE or 
an SES»SENDPF as part of the job. If neither of these are codeds 
the output is printed at the remote site where the job is run. 


A user job for 180 mode execution (lapplicabte to the $2 site 
only) automatically has its output returned and printed at the loca! 
site where the user originated the job. 


f or fn 3 
name of File containing the job to he orocessed, 


at or on: 
site-id of the mainframe that the job is to run on. 


mode : 
{optional) value (170 or 180) to indicate execution mode for 
the job at the remote site; default is nodez170; the mode 
parameter is applicable only to jobs to be run on the $2 
remote site. 


You can set a default for the mode oaraneter by defining the 
submode variable in your profile. For instances \SUBMOGDE=180 in the 
PROFILE submits all jobs in 180 mode unless modez170 is coded when 
the SUBMIT proc is run. 
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16011 GETPE_=_GET_A_ PERMANENT FILE FROM A_QEMOTE SITE 


GETPF ACQUIRE's a file from a remote mainfrane and makes a copy 
of it in your catalog on the tocal mainfrane. The copy created on 
the focal mainframe is a direct access file. If the file is not 
under your user number on the remote nwnainframes you must have 
permission to access the file. 


The procedure is arranged so that it does not abort. If there 
are any errors detecteds the NOS Job Control Register calied EFG is 
set to a non-zero valuee This feature is used when this procedure 
is being used as a building biocks to determine what steps should be 
taken subsequent to running the procedure. 


Parameters to GETPF are : 


rfn: 
name of file to be acquired on the renote nainframe,. 


at or on 3 
site-id of the mainframe From which the File is to be 
acquired. 


un 3 
{optionalt) user number of the catalog the file is under on the 
remote mainframe. If this parameter is not codeds GETPF uses 
the user number value for this site fron your PROFILE. 


hfn 3% 
(optional) name to be used for the cony of the file created in 
your catalog on the local mainframe. If this parameter is not 
codeds GETPF uses the value for rfne [fF hfn already exists in 
your catalogs GETPF terminates with an error status. If hfn 
doesn't exists GETPF creates hfn as a direct access file. 


passwrd or pw : 
{optional) password for the file on the renote mainframe. 
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16.12 JENDPF_-_SEND_A_ PERMANENT FILE _T0_A_REMOTE_SITE 


SENDPF copies a fiie from a focal. natinframe to aeéeremote 
mainframe. If the file already exists» it is rewritten. 


The procedure is arranged so that it does not abort. If there 
are any errors detecteds the NOS Job Contro! Ragister called EFG is 
set to a non-zero valuee This feature Is used when this procedure 
is being used as a building blocks to determine what: steos should be 
taken subsequent to running the procedure. . 


Parameters to SENDPF are 3; 


hfn 3: 
name of file on the local mainfrane that is to be copied to 
the remote mainframe. 


at or on: 
site-id of the remote mainframe, 


un: 
(optional) user name that the local file is cataloged under. 
If this parameter is not codeds your’ user nane Is used. 


rfn ? 
(optional) name of file to be created on the remote nainframe,. 
If this parameter is not coded» SEND: uses the vatue of hfn. 
If file rfn already exists on thea remote nainframes SENDPF 
writes the new file over it. SENDPF creates rfn as aie direct 
access file. 


passwrd or pw 3 
{optional) password associated with the File on the remote 
mainframe. 
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16513 CHANGPE =_CHANGE. PARABETERS_OF_A_PESMANENT_EILE 


CHANGPF modifies parameters of a permanent file on a eremote 
mainframe without re-defining it. Parameters for SHANGPF are : 


ofn : 
name of the file on the remote mainfrane to be changed. 


at or on ? 
site-id of the remote mainframe. — 


nfn 3: 
(optional) new name of the file on the renote mainframe, 


ct 3: 
(optional) new file category. Must be P {(private)s § 
{semiprivate) or PU (public). If the parameter is not codeds 
the file category is not changed. 


m3. 
(optional) new access mode for the file. Must be Wiwriteds 
M(modify) » Alappend)>» R(read)>»s R4M(readnd)s RA(readap)» 
Elexecute)s or N{nulle-removes permission granted by permission 
commands). If the parameter is not codeds the access mode 
isn't changed. 


pw 3 
{optional) new password (1 to 7 characters) for the fite. If 
this parameter is not codeds the password isnit changed. 


status or nostat : 
coding the (optional) status key causes a message to be placed 
in your mailbox when CHANGPF completes. When the nostat key 
is codeds you arentt notified when CHANGPF completes. The 
default is no message upon completion. 


16-206 
CDC ~ SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: 4A 


16214 PURGPF - REMOVE (PURGE) A PERMANENT FILE 


16.14 PURGPF -_ REMOVE (PURGE) A PERMANENT FILE 


PURGPF removes a permanent file from a remote mainframe. If the 
file is not in your own catalogs you must have write permission in 
order to purge its Parameters for PURGPF are 3. 


ofn 3 
name of file to be purged. 


at or on : 
the site-id of the remote mainframe. 


un. 3 
(optional) user name on the remote nairafrane that ofn is 
cataloged under. 


status or nostat : 
coding the foptional) status key causes a message to be placed 
in your mailbox when PURGPF compietes. When the nostat key is 
coded you arentt notified when PURGPF conpletes. The default 
is no message upon completion. 
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16.15 PERMPE_=_ PERMIT _ACCESS _T0_A_ PERMANENT LEILE 


PERMPF explicitly permits another user to access: a file in your 
catalog on a remote mainframe. Parameters to PERMPF are 3: 


ofn : 
name of fite for which access is being oermitted. 


at or on 3 
site-id of the mainframe the file fs: on. 


un 3 
user name to be permitted access to the file,’ 


{optionai) permitted mode of accass. If this parameter is 
not codeds R tread) permission is used. 


status or nostat : 
coding the (optional) status key causes a message to be 
placed in your mailbox when PERMPF compietes. When the 
nostat key is codeds you arentt notified of PERMPFis 
compietion. the defauit is no message unvon completione 
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16.16 CATPE_=_QISPLAYS_INFORMATION. ABOUT_A_EILE 


CATPF dispiays CAT!ist information about Permanent Files on a 
remote mainframe. Parameters to CATPF are 3 


ofn : 
{optional) file name that catalog information is desired for. 


at or on 3 
(required) site-id of remote mainframe to get catilist 
information from. 


un 3 
{optional) user number of an alternative catalog on the remote 
mainframe. 


fo : 
(optional) tist options for NOS CATLIST command. Default Is 
full information (F). 


fisting or § : 
(optional) name of file on the focal mainframe to receive 
fisting. If this parameter is not codeds the listing is 
printed at the local mainframe central site. 


status or nostat ; 
coding the (optional) status key causes a message to be placed 
in your mailbox when CATPF completes.’ When the nostat key Is 
codeds you aren't notified of CATPFE*s conpletion. Default is 
no message upon completion. 
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16.17 DISPOSE = _PRINT_A_FILE_AT_A_REMOTE SITE 


DISPOSE prints a file from the local mainfrane 9n a eprinter at 
the remote mainframe. Parameters to DISPOSE: are 3 


file or f 3 
name of file to be printed. 


at or on 3? 
site-id of remote mainframe where file is orinted. 


print or p 3 

(optional) string containing parameters to controi the action 
of the SES PRINT procedure which is used to print the file at 
the remote site. If you dontt code the print oarameters 
DISPOSE prints one copy of the file at the remote site. For 
a complete description of the values that may be coded for 
the print parameters see the descriotion of the procedure 
PRINT in the SES USERS HANDBOOK. 
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16.0 SES COMMUNICATIONS 
16.17 DISPOSE — PRINT A FILE AT A REMOTE SITE 


Alphabetical Summary_of Remote Link Procedares 


Non—bracketed parameters are required. 


CAT PF Lofn]» ats Eunls [Clols {tistingl]s [status] 
CHANGPF ofns ats (Unfnjs {ctls Cm» [powal>s {status} 


DISPOSE files ats forint] 


GETPF rfns at» Lunls fhfnil» Cow) 
PERMPF ofns at» uns {ml> Cstatus] 
PURGPF ofns ats Cunl]s [status] 


SENDPF hfns ats Cunls [Erfnl» Cowl] 


SUBMIT fi» ats Cmode]j 
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17.0 TEXT_MANIPULATION AND. CONVERSION UTILITIES: 


This section describes a fist of facilities to perform general 


massaging 


text filess character set conversion and so one. The 


facilities to be described are 3 


EDT 


LOWTOUP 


UPTOLOW 


COPYACR 


ASORT 


UNIQUE 


MERGE 


DEMERGE 


COMPARE 


COUNT 


SELECT 


MULTED 


run the EDT text editor ona File. 


convert flower case tetters to uoner cases 


convert upper case fetters to lower case. 


copy ASCII coded recorde 


sort ASCII files. 


removes adjacent dupticate tines fron a text file. 


merge up to five files on a columnar basis. 


split a file into one to five ftites on a cotumnar 
basise 


compare two text files and oroduce a ftisting of the 
differences between them, 


counts characterss wordss or tines in a text file. 


extracts (displays) selected fines and/or ranges of 
lines from a text file. 


MULTI record file EDIT facility. 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 


PACK "Packs" a muiti record or nulti fite file into a 
single text records with contro! characters such that 
it can be “unpacked"™ again. 


UNPACK. “Unpacks™,s that iss reverses the action of PACK. 
CONV CONVert the character set of a text file. 
JABFORM convert source for the TEXTJA8 document formatter to 


source for the TXTFORM docunent formatter. 


WANG2CYBER send text from a WANG document to a CYBER file. 


CYBER2WANG send text from a CYBER file to a #4ANG document. 


SNOBOL Bebit SNOBOL interpreter, 
FIND search a file for specified taxt oatterns. 
CHANGE change matched text lines in a file. 


XLIT transtiterate characters in a file. 


17-3 
CDC - SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User’: Handbook wens 4A 
17.90 TEXT MANIPULATION AND CONVERS ION UTILITIES 
17.21 EDT - RUN THE EDT TEXT EDITOR 


171 EQT.=_RUN_THE_EDI_TEXT_ EDITOR 


EDT runs the EDT text editor for you. EDT is any enhanced version 
of the standard NOS text editor. <A descriotion of EDT can be found 
in an appendix to this document. This ENT orocedure is mainty 
intended to work in conjunction with procedures such as GETMOD(S)» 
GETMEM(S)>» PACKs UNPACK and so ons so that you cans for instances 
string a bunch of procedures togethers like 3 


sesegetmod mzenurdie; edt3 reprnod 


to get a module off a bases edit it and replace it all in one 
procedure line. Parameters to EDT are : 


ior f 3 
(optional) name of Input File containing text to be 
EDiTed. If you don't code the i oarameters EDT uses the 
vaiue of profile variabfe group as the name of the input 
files and if there's no such variahle defineds EDT uses a 
defauit file name of group. 


ec or input : 
{optional) name of file containing EdAIt Commands to EDT. 
If you dontt code the ec parameters EDT uses fiie input. 


eo or output : 
{optional) name of file to receive Edit Output. If you 
don't code the eo parameters EDT uses file output. 


t or tabs : 
(optional) TABS parameter for ENT. If you don't code the 
t parameters there are no tabs sete You may set up a 
default tabs name in your profite® by defining the tabs 
variable, 


save or rep : 
if you code this (Coptional) key» ENT REPIlaces the file 
specified by the i parameter in your catatog when you've 
finished editing. If you don*t code the rep keys the file 
is teft tocal. 
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17e2 LOWLOQUP_-_ CONVERT LOWER CASE _TO_ UPPER CASE 


LOWTOUP converts ali LOWer case ltetters in a text file to UPper 
case Jetters.e. Parameters for LOWTOUP are 3° 


jor f : 
name of Input File containing text to be processed by 
LOWTOUP,. 


{optional) name of File to receive the Qutput from 
LOWTOUP. If you don't code the o parameters the output 
appears on the file specified by the 4 oarameter. 


Exampie of LOWTOUP Jsage 


seseliowtoup iszlowcases ozupcase 
REVERT. END LOWTOUP LOWCASE =-> UPCASE. 


This example shows LOWTGUP converting afl’ toaer case letters in a 
file called fowcase into upper case fetterss and oroduce the output 
on a file called upcase. 
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17-3 UPTOLOW =_ CONVERT UPPER CASE _TO_ LOWES CASE 


UPTGLOW converts ali UPper case Jetters in a text file to LOWer 
cas@e Parameters for UPTOGLOW are : 


ior f 3: 
name of Input Fite containing text to be processed by 
UPTOLOW. 


e 
es 


(optional) name of file to receive the Output from 
UPTOLOW. If you dontt code the o oarameter,s the output 
appears on the file specified by the #4: voarameter,. 


Example of UPTOLOW Usage 


seseuptolton izuppers ozlower 
REVERT. END UPTOLOW UPPER => LOWER 


This example shows UPTOLOW converting all woper case letters in a 
file cailed upper to lower case letterss and oroducing the output on 
a file calied tower. 
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17-4 COPYACR =_ COPY ASCII _ CODED RECORD(S) 


COPYACR stands for COPY ASCII Coded Record(s)» and as its name 
implies» it is the ASCII equivalent to the standard NOS COPYCR 
utility. This COPYACR procedure does a bit:' nore than the standard 
NOS COPYCR : it acquires the input File for yous and rewrites the 
output file back over the input file if you specify it that way. 
COPYACR can also perform some character set conversions for you (see 
below). Parameters to COPYACR are 3: 


ior f 3 
name of Input File containing text to be processed by 
COPYACR. 


(optional) name of file to receive the Qutput fron 
COPYACR. If you don't code the 0 oarameters the output 
appears on the file specified by the i> parameter. 


cols or c ? 

(optional) specification of the CILunnS between which the 
file is to be copied. The ec parameter’ must be coded as a 
ranges or in the form ftoweehighs where tow is the teft 
column at which to start copyings and high is the right 
column beyond which the file is not to be copied. If you 
don't code the c parameters, COPYACR uses the range 14-80 
for the copy. 


incset or ic : 
(optional) designator for the [Nout file*s Character SET. 
The table below describes the allowed designators. 


outcset or oc ; 
(optional) designator for the O0UTput File's Character SET. 
The table below describes the allowed designators. 


Both the incset and outcset parameters default to cs6l2 (see 
below) but this can be over-ridden by defining tn your profile 
defauits via variables with names the sane as the parameters. The 
following table defines the allowed designator’s. for’ the ineset and 
outeset parameters ;: 
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Qesignator : Meaning 
4 
So oe ne AD ee ee ee ae ee sae sane cee ae eee ee cca ate sane eget ME ED SD A SY OD SE MD ERS ae ae ee ee ES SE ER AIRY ar RD CR ee cae 
; 
es612 + NOS 6/12 ASCII character’ set 


cs 64 character ASCII subset (display code) 


& 
haracter set 


Oo Oo 


oe “#0 282 Ge 


os812 "8 out of 12” ASCII character set 


we ow ae ep oe oe we ow a we we ww 4 06 we we 


66 we we ae we we wm tp 68 we ee tp Oe we 
i mt 


Example of COPYACR Jsage 


sesecopyacr grab hotd 11..17 
REVERT. END COPYACR GRAB -> HOLD 


This exampte shows COPYACR copying file grab between columns 11 
thru 17 inclusives and placing the resuit of the copy on file hold. 
You might wonder what's the use of doing that? Well the NOS CATALOG 
utility outputs the record names starting in column lls so you could 
use this examoie of COPYACR to isolate afl the record names. 
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17-5 ASORT_.=_SORT_ASCIT_EILES 


ASORT is a utitity to sort ASCII files according to sets of sort 
directives. Parameters to ASORT are ? 


ior f 3 
name of Input File to be processed by ASORT,. 


(optional) name of file to receive the Jutput from ASORT. 
If you don't code the o parameters. ASURT places the output 
file on the file specified by the f° paraneter. 


keys : 

list of sort KEYS to direct the sort process. Each 
element in the list of keys consists of three items. The 
first item is the start colunn of the fieids the second 
item is the (optional) tength of the Field {defauit 1 
character)s and the third itamn Is: the (optional) sort 
orders A for Ascendings and D for Descending. The default 
is Ascending order. There is an examote of ASORT at the 
end of this description. 


retain : . 
this Coptional) key is the SORTS RETAIN option, If you 
don't code the retain keys SORTS outouts identically keyed 
records in arbitrary order. If you do code the retain 
keys such records are output in their ortginal order. 


Note : the collating sequence for ASJVRT is the ASCII cottating 
sequence. Upper and tower case fetters are considered identical for 
the sort processs so that alphabetic itens aren't separated by an 
entire case of the alphabet. 
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Example of ASORT Usage 


seSeasort izshuffids ozorderlys keys=((157)9(1057sd)s(2154)) 
REVERT.» END ASOGRT SHUFFLD -> ORDERLY’ 


This example shows ASORT sorting the file shuffid onto the file 
orderly. The keys used are cotumn 1 for aéetength of seven 
characterss in ascending order (since that's the default)» column 10 
for a tength of seven characters in descending orders and cofumn 21 
for a tength of four characterss in ascending order {again 
defaulted). 


seseasort izhiggidys ozlinedups keys=€(14s 35 d)? 
REVERT. END ASORT HIGGLDY =-> LINEDUP: 


This example of ASORT highlights one of the minor inconveniences of 
parameters that are lists of tists» namely» that even when youve 
onty got one key to sort ons you still need double oarentheses. The 
following discussion explains the keys paraneter.. 

The keys parameter is a list of sort keys; each element of that 
tist is itself a tist of up to three elenants. $3 at the top level 
you get this situation : 

keysa(key_ls key_2»9 key _3see0%% key_n? 
each key_i is itself a Jist of one to three elements :;3 
(start_columns key_ftengths sort direction) 
start _column is the column position of the start of the sort key. 


key_length is the number of characters in the keys inclusive of 
start _column - the default key_fength is 1.) 


sortidirection is a single fetter indicator’ : A for Ascending order 
(the default), D for Descending order. 


So tet's look at some real live examples of sort keys : 
keys2=((4» 25 dds (1ll»s 7s d)) 


is a list for two sort keys» the first starts fn column 45 is 2 
characters tongs and is sorting in descending order; the second 
starts in column lls is 7 characters tongs and is atso sorting in 
descending order. Here's the same tists but this time the sort 
order is ascendings so you can leave out the direction indicators ? 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17.5 ASORT - SORT ASCIT FILES 


keys={((45 2)59 (11s 793 


Now let's fook at some more default cases; supvoose the column 4 key 
is only gone character tong - now you can write the keys tike this ? 


 Keys=(4s Ll)» Cll» 79). 
but the key_ftength of one is the defaults so it can be written : 
keys=((4)5 lls 7))- 
harking way back to chapter 1 and the section called “tists of 
values for parameters", recall that a singte etement tist doesnitt 
need the parentheses : 


keys(45 (11s 7)) 


Now fet’s shorten it still further by reducing the seven character 
field to one 3; 


keys=(4,» 11) 


Getting down to the minimum case of a single key of tength one in 
ascending orders you get ; 


keyss4, keys2=((45 1)) and keys2=((4» ls a}) are ail identical, 
whereas :3 


keys=(7» 12) means keys2((7s5 L)»s €125 19) 
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17.6 UNIQUE -_ REMOVE ADJACENT DUPLICATE LINES_EROM_A_FILE 


UNIQUE removes adjacent duplicate tines fron a text file. Such a 
situation usually arises when a file has heen sorteds (as for 
exampie with the ASORT procedure previously described) and duplicate 
lines in the file are all together. UNIOJE provides the capability 
of reducing the file to one instance of each uniaque tine. For 
examples UNIQUE acts as follows ; 


Ineut Eile Dutout Eile 
Just the piace for a Snark Just the olace for’ a Snark 
the Beliman cried the Beliman cried 
the Bellman cried as he landed his crew with care 
as he ianded his crew with care supporting each one 
supporting each one on the too of the tide 
on the too of the tide with a finger entwined in his hair 


on the top of the tide 
on the top of the tide 
with a finger entwined in his hair 


With that example to show how it works» the parameters to UNIQUE 
are 3 


ior f : 
name of the Input Eite containing the text which is to have 
the adjacent duplicate lines removed. 


is the f{optional) name of the Qutout file from the UNIQUE 
processe If you don't code the 90 parameter, the results 
appear on the file specified by the 4 oarameter,. 
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Examples of UNIQUE Usagee 


seseunique izsorteds ozremoved 
REVERT. END UNIQUE SORTED -—> REMOVED 


Sseseunique duplics 
REVERT. END UNIQUE DUPLICS 
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17.7 MERGE = MERGE UP TO FIVE FILES _INTO_OVE_LEILE 


MERGE combines up to five files on a colunnar basis. Parameters 
to MERGE are 3 


name of file to receive the Output of MERGE. 


moor merge 3 
a fist of up to five cotfumn widths soecifying how the 
input files are to be MERGEd into the output file {see the 
example below). 


ior f 3 
(optional) tist of up to Five Inout Fites to be MERGEd 
onto the file specified by the o oarameter. If you dontt 
code vaiues for the & parameters MERGE uses filenames 
tapel thru tape5 for its input files. 


Examptie of MERGE Usage. 


sesemer ge ordiagrams m=(21s21921)»5 fiz(colunnls column2,s column3) 
REVERT. END MERGE COLUMN1 »sCOLUMN2sC3LUMN3 => DIAGRAN 


In this examples MERGE is constructing a File called diagram, by 
merging together the three files columnls coliemn2»s and column3. The 
contents of file columnl occupy the first 21 sotunns in the diagram 
files the contents of file column2 occupy columns 22 thru 42 in the 
diagram files and the contents of file colunn3 occupy columns 43 
thru 63 in the diagram file. 
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17-8 DEMERGE =_SPLIT_FILE_APART_ BY COLUMNS. 


DEMERGE splits a file into one to five files on a columnar basis. 
Parameters to DEMERGE are : 


ior f 3: 
name of Input File which is to bea DEMERGEd. 


d or demerge : 
a fist of up to five cotunn widths specifying how the 
input file is to be DEMERGEd into the output files {see 
the example below). 


(optional) tist of up to five fites to receive the Output 
of DEMERGE. If you don*t code values for the o parameters 
DEMERGE uses tapel thru taped. 


Exampie of DEMERGE Usage 


sesedemerge izcompiles d=(81s23)s5 oz(sources numbers) 
REVERT. END DEMERGE COMPILE => SOURCEs NUMBERS 


This exampie shows DEMERGE splitting uo a fitte calied compile 
into two components. In this example (taken from real tife)s the 
first 81 columns of compife are the source statements from a master 
audit of a deck in an UPDATE PL» and the tast 23 columns are the 
statement numberse The two separate sets of data appear in the 
example on files source and numbers. 
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17.9 COMPARE ~_ COMPARE _TEXT_EILES 


The COMPARE procedure compares two text Files and produces a 
"1isting™ of the differences between them in terms of inserteds 
deleteds and replaced lines. Parameters to COMPARE are 3 


new : 
this (optional) parameter specifies. the name of the file 
containing the "new" version of the text. If you don't 
code this parameters COMPARE uses’ a file called new. 
old 3 
this (optional) parameter specifies: the name of the file 
containing the "“oid™ version of the text. If you dontt 
code this parameters COMPARE uses a file called oid. 
0 3 
this (optional) parameter specifies the name of the file to 
receive the output from COMPARE. [f you don*t code this 
parameter, COMPARE writes the results 3f the comparison to 
file output. Note that if the two files are equivalents 
COMPARE doesn't write anything to the o file. 
neweset ; 
(optional) designator for the NEW Fillets Character SET. 
The table below describes the allowed designators. 
oldecset : 
(optional) designator for the OLD file*s Character SET. 
The table below describes the allowed desioqnators. 
outeset : 


(optional) designator for the OUTout file's Character SET. 
The table below describes the allowed desitaqnators. 


fs or ignoris : 
these (optional) keys specify whether or not to JGNORe 
Leading Spaces on tines being compared. The default action 
is to recognise fteading spaces (the ts option). If you 
code the ignorits keys COMPARE ignores teading spaces on 
text lines. 
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The default character set designator for all three | cset 
parameters is ¢5612. The following table defines the allowed 
designators for the cset parameters ;: 


Sh ee ee ee ee ee ce ee ene sae Se se ee tte ae ee ce ee cee at a ce ae oe Oa a OS PS SE SOR SO A A SO SD AO “SND + 
H H ; 
: Designator : Meaniag ; 
en ee ee ee eee a 
H ; H 
; cs612 + NOS 6/712 ASCII character’ set: ; 
3 a gs 
9 S| 9 
oe ee a re ee ee ef a nn i nw + 
: ; H 
H cs64 :; 64 character ASCII subsat (display code) ; 
H :; character set ; 
‘ : H 
ow wwe A ae aD He ale a a ey ae +> 2 ae AS A AS ES DS OS AAD AD DD AE NS DOD“ DE SD DONA AD EE ED SE OO a ER a a ee came ae Ae 
; H H 
H cs812 ; ™8 out of 12% ASCII character set H 
: 3 a 
4 3 % 
+ + 


| 
| 
i 
t 
i 
) 
i 
j 
' 
! 
i 
$ 
' 
t 
i 
{ 
! 
' 
| 
! 
! 
j 
§ 
‘ 
i 
! 
i 
‘ 
' 
! 
‘ 
§ 
' 
! 
I 
1 
| 
' 
( 
i 
i 
' 
! 
‘ 
' 
! 
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17.10 COUNT =_COUNT THINGS IN_A_EILE 


COUNT counts one of the following three things in a file ; 
characters number of ASCII characters ina file. 
fines number of lines. 
words number of words in a files where a "word" is defined as a 
contiguous set of characters delimited by space(s), 
tab(s) or newline(s). 
Parameters to the COUNT procedure are ?. 
c or chars or 4 or lines or w oor words 3. 


these keys define which thing is to be counted (Characters,» 
Lines or Words). 


ior f or in ?: 
name of Input Eile IN which the things are to be counted. 


o or to : 
is the (optional) name of the Jutput File [Q which the 
results of the counting process ar’? to go.’ If you don'ft 


code the to parameters the results go to file output. 


Examples of COUNT Usage 


sesecount lines in source 
7396 
REVERT. END COUNT SOURCE 


sesecount words in guide to resuits 
REVERT. END COUNT GUIDE <-> RESULTS 


The first example shows COUNT counting the nunber of tines in a 
file called sources with the resuit going to file output by default. 
The second example counts the number 3f words in a file called 
guides with the answer written to a file called resutts. Note that 
the choice of parameter keywords means 42 can specify the COUNT 
process in amore "English" form. 
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17011 SELECT -_ COPY SELEC TED_LINE_RANGES_ ERJSUWALEILE 


SELECT copies selected lines or ranges of tines from one file to 
another. The default output file used by SELETT is in fact file 
output» so that the utility provides an easy way to took at. selected 
parts of a file without needing to edit the file.» Parameters to the 
SELECT procedure are 3:. 


line or tines : 
is a list of tine numbers or tine number ranges to be 
selected from the input. file. 


ior f or of 3: : 
is the name of the Input Eile from which the lines or 
ranges of lines are to selected. 


o or to 3: 
is the (optional) name of the Qutout file JQ which the 
selected fines are to be copied. [If you don't code the to 
parameters the selected tines go to file output by default. 
You can code the output file nane to be the same as the 
input file name in which case the input File gets 
overwritten by the selected lines. 


Examptes of SELECT Usage 


seseselect tine 50 of somfile 
Beware the frumious Bandersnatch my sone 
REVERT. END SELECT SOMFILE 


seseselect tines 102-19 of nurdie to twisted 
REVERT. END SELECT NURDLE -> TWISTED 


seseselect lines (5597990e179199230247) of primes to sifted 
REVERT. END SELECT PRIMES -> SIFTED 


The three examples shown above should give a good idea of the way 
that SELECT is useds showing a single iines a rang2 of fines» and 
finally a list of tines and line rangese Invalid tine numbers and 
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ranges are diagnosed. Line ranges in which the high end of the 
range is larger than the number of fines in the inout file cause the 
selection to go to the end of the input file. 
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17612 MULTED =_EDIT MULTI RECORD _EILE 


MULTED provides the ability to edit a multi record file. This is 
especially useful for instances where major’ and global changes must 
be made to many decks of a source text program tibrary.e. It fs easy 
to generate a SOURCE files MULTED that files then repiace the decks 
on the PL. MULTED uses the PACK and UNPACX orocedures to change the 
muiti record File to a single record file ready for editings and to 
reverse the process when editing is complete. MULTED invokes the 
EDT text editors an enhanced version of the standard NOS text 
editor. A description of EDT can be found In an appendix to this 
document. Parameters to MULTED are: 


ior f: 
name of File containing MULTED inout.. 


(optional) name of file to receive the Output from MULTED. 
If you don't code the o parameters the output appears on 
the file specified by the i paraneter.: 


ec or input : 
{optional) name of file containing Edit Commands to be 
used by EDT.» If you don't code the ee parameters MULTED 
assumes that the edit commands are coning From file INPUT. 


eo or output :; 
(optional) name of file to receive Edit Output. If you 
don't code the eo parameters MULTED assumes that the 
output is going to file OUTPUT. 


tor tabs 3 
(optional) TABS parameter for EDT.’ IF you don*t code the 
t parameters MULTED doesn't set any tabs. You may set up 
a default tabs name In your profite by defining the tabs 
variable. 


(optional) Control Character to be used for the 
PACK=UNPACK process. If you don*t code the ceo parameters 
MULTED uses a control character of stash (7). 
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save or rep : 
if you code this (optional) keys WILTED REPIlaces the file 
when editing is complete. IF vou dont*t code either of 
these keys» MULTED leaves the fil® tocal. This parameter 
is only applicable on indirect access files. 


Example of using MULTED. 


sesemuilted rigors mortices ccs??? 


This example PACKs file rigors invokes EXT to edit the PACKed 
files and finally UNPACKs the file onto file mortice. The PACK 
process turns ali physical EGR's and EDF's into the character 
strings 7EQR and ?EOF respectivelys and tha JNPACK process reverses 
the operation. 
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17.13 PACK = PACK MULTI_RECORD EILE 


PACK packs a multi record file into a singie record in such a way 
that the record structure is maintaineds and may be reconstituted by 
a subsequent UNPACK. It is a useful facility when you want to edit 
a multi record text file for instance. Par'aneters to PACK are? 


ior f : 
(optional) name of Input Fite to be PACKed. If you dontt 
code the | parameter:s PACK uses the name associated with 
profile variable group». If there tisntt such a profile 
variable defineds PACK uses a filename of group. 


0 2 
(optional) name of file to receive the OQutout from PACK, 
If you omit this parameters the sutout aopears on the file 
specified by the i parameter. 

cc 3 


{optionai) Contro! Character to he used for the PACK 
process. If you dontt code the ce paraneters PACK uses a 
control character of stash (/). 


ineset or ic ? 
designator for the INput file's Character’ SET. See the 
table below for a description of the allowed designators. 


outecset or oc : 
designator for the OUTput file's Character SET. See the 
table below for a description of the allowed designators. 


The foliowing tabie defines the designators allowed for the 
incset and outcset parameters: 


Designator Meaning 
C$612 6/12 character sat (default) 
CS$64 display code character set 


C$812 8 out of 12 ascii character set 
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Example of PACK Usage 


sesepack izmultrecs ozpackeds ccz!!! 
REVERT. END PACK MULTREC => PACKED -, 


This example shows PACK being used to "sack" a nulti record file 
called multrec and oeroduce the output of the process on a fiie 
calted packed. The control character ? is: useds so that every 
physicai EOQR in the file is replaced by the character string EGR in 
the output. 
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17214 UNPACK =_UNPACK TEXT FILE TO _ MULTI _BECIQRD FILE 


UNPACK provides the converse operation t3 that orovided by PACKs 
or it unpacks a single record text file into a nufti record file. 
Parameters to UNPACK are: 


ior f 3 
{optional) name of Input File containing data to be 
processed by UNPACK. If you don't code the i parameters 
UNPACK uses the name associated with profile variable 
group. If there isn*t such a orofile variable defined» 
UNPACK uses a file name of group.’ 


032 
(optional) name of file to receive the Output from UNPACK. 
If you don't code the o parameters the output appears on 
the file specified by the i paraneter, 

cc 3 


(optional) Control Character to be used for the UNPACK 
processSe If you don*t code the ce paraneters UNPACK uses 
a control character of stash (/).: 


incset or ic 3; 
designator for the INput File's Character ‘SET. See the 
table below for a description of the altowed designators. 


outeset or oc 3 
designator for the OUTput file's Character SET. See the 
table below for a description of the allowed designators. 


The following table defines the destianators atltowed for the 
incset and outcset parameters: 


Designator Meaning 
C$612 6/12 character set (default) 
CS64 display code character set 


C$812 8 out of 12 ascii character’ set 
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Exampie of UNPACK Usage. 


seseunpack izpackeds ozunpackds cc=z*!]?' 
REVERT. END UNPACK PACKED => UNPACKXD 


This example shows UNPACK being used to reverse the “pack 
process described in the previous section. The file packed is 
funpacked! onto the fiie unpackd. The control character of ! is 
used so that every tine that has a !EOR startina In column one is 
replaced with a physical end of record in the outout file. 
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17215 CONV.-_CONVERT CHARACTER SET 


CONV converts text files from one character set to another. If 
the text file contains EDFss» CONV will stop at the first EOF 
encountered. NOTE —- Due to its flexibilitys the conversion process 
is fairly time consuming. Parameters to CINV are 3 


ior f : 
name of the Input File containing text to be converted. 


{optionat) name of the file to receive the Output from 
CONV. If you don't code the o parameters, the output 
appears on the file specified by the + parameter. 


incset or ic ; 
designator for the INput file’s Character SET. See the 
table below for a description of the allowed designators. 


outcset or oc : 
designator for the OUTout filets Character SET. See the 
table below for a description of the allowed designators. 


The following table defines the designators allowed for the 
incset and outcset parameters: 


Designator Meaniog 

N63 NOS 63 6—bit codes 

N64 NOS 64 6-bit codes 

N612 NOS 6/12 ASCII 6—bit and 12-bit codes 

N612U same as N612 except that aff fetters are upper 
case 

N612L same as N612 except that all fetters are flower 
case 

NBE63 NOS/BE 63 6—bit codes 


NBE64 NOS/BE 64 6-bit codes 


17-27 
CDC —- SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: 4A 
17.2.0 TEXT MANIPULATIGN AND CONVERSION UTILITIES 
172.15 CONV —- CONVERT CHARACTER SET 


A A SN A A SN NE A ARN ATO AD HERD AED AND OND AD ND A A RS ES OS END AN ND DD ANDES NED ANG EOD ED SEED OY SRP AE A AED AN A AND - SOD AND AED A ND AT -AED -AED «AD A AD AED AD EY CD AD “A ED “A ee 


NBES534A NOS/BE ASCII 63 character subset V-bit codes (5 
per word) 

NBEOGA NOS/BE ASCII 64 character subset 77-bit codes (5 
per word) 

ASCII4 full ASCII TV-bit codes (4% per word) 

ASCII5 full ASCII 7-bit codes (5 per word) 


A table of these characters sets can be Found in an appendix to 
this document. 
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17.16 JABFORM_ -_ CONVERT TEXTJAB_ SOURCE TO TXTEQRM SOURCE 


JABFORM converts source for the TEXTJAB document formatter to 
source for the TXTFORM document formatter. JABFORM only works on 
TEXTJAB source format directives that are delimited. Parameters to 
JABFORM are 3? 


ior f 3: 
name of the Input File containing the TEXTJAB document 
sourcee 


oO 
oe 


name of the file on which the TXTFIRM source is written 
Out. Note that untike many other SES procedures JABFORM 
doesn*t overwrite the Input file with the Output File. 


(optional) name of the file to receive error messages from 
JABFORM. If you don't code the e parameters JABFORM uses 
File ERRLIST. 


A complete description of the conversioxrs o>%erformed by JABFORM 
can be found in an appendix to this document. 
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17.17 WANG2CYBER -_ SEND TEXT FROM WANG O0C._ TO CYBER _EILE 


WANG2CYBER transmits a document from a WANG to a text file on a 
CYBER. To perform the transfers, a WANS telecommunications 
environment is necessary. Parameters for WANG?CYRER are 3 


o 3 
(required) name of the text file an CYRER.. If this file 
already exists» WANG2CYBER will anpend the WANG document to 
the end of this file. If this file doesn't exists 
WANG2ZCYBER will create a direct access file in the catalog 
of the current user. 

un. 3 


(optional) user name in whose catatiog the text file 
specified by the o parameter is to be found. If you dontt 
code the un parameters WANG2CYBER uses the user name of the 
current user. 
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17.18 CYBER2ZWANG_=_SEND_TEXT_ EROM CYBER FILE_TO_LWANG DOC. 


CYBER2ZWANG transmits a text file from a tY8ER to a document on a 
WANG.s To perform the transfers a #4ANG telecommunications 
environment is necessarye Parameters for CYBER2WANG are 3 


ior f 3 
(required) name of the text file on CYBER. 


un 3 
(optional) user name in whose catalog the text file 
specified by the i or f parameter’ is: to be found. If you 
donft code the wn parameters CYBER 2WANG uses the user name 
of the current user. 


txtcode or txtform : 
(optional) key indicating to CYSER2WANG that the text file 
specified by the i or f parameter is txtcode or txtfora 
source. If you don't code the txtcode or txtform key 
CYBER2WANG assumes that the text Is neither txtcode or 
txtform source and transmits the text asise 


os 


(WARNING: The TXTCODE or TXTFORM source nust be capable of being 
formatted by using the BACKUP parameter an. SES.~FORMAT.) 


If you transmit txtcode or txtform sources a WANG’ conversion 
glossary is available to further massage your document once WANG has 
it. Please cali Betty Hawes on Controtnet No. 235-3019 {or 
612-482-3019) and arrange to obtain the WANG Format Glossary 00001. 
Once you have obtained the glossary» attach it to vour document = and 
execute glossary entry P3; then execute glossary entry Le 
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17019 SNOBOL ~-_ 8-BIT_SNOBOL INTERPRETER 


SNOBOL is an 8=—bit version of the SNO89L4 interpreter. SNOBOL 
afficionados witt realize that SNOBDOL requires both program and data 
on the same input file; using the SES SNOBOL procedure you can (if 
you want) have the program and data on separate filtess in which case 
SES gathers them onto the same file befor’e running SNOBOL. The 
SNOBOL interpreter requires its input in 8-12 ASCII: and produces its 
output in the same character set» Parametar’s are 3° 


ior £;: 
name of Input Eile containing the SNOBOL source programs 
ands if you wishs data for the programe You can also 
specify a data file with the d paraneter, 


d or data : 
is the loptional) name of a Data file for the SNOBOL 
program. If you do code this parameters, the data file is 


appended to the input file specified by the {i parameter, 


(optional) name of file to receive the Qutput of the SNOBOL 
rune If you don't code the o paraneters the output appears 
on the File specified by the i paraneter. 
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17.20 FIND. =~ FIND _PAITERNS_IN_A_EILE 


FIND searches a file tine by tines tooking for’ specific text: 
patterns or regular expressions. There is a discussion on reguiar 
expressions later. The pattern to be located in the file may be 
specified on the SES control statements ors if there are tower case 
characters which can*t be represented» an argument file (default 
input) may be supplied. Parameters to FIND are : 


p or pattern or with or using 3 

(optionat) pattern specification. If you: dontt code this 
parameter at alls FIND takes its argument pattern from file 
inputs» and prompts you accordingly. The p or pattern 
keywords or no keyword indicate that the sattern is right 
there on the SES control statenent. The with or using 
keywords indicate that the pattern ts: in an argument file 
which is specified as the value of the parameter, 


ior inoor f : 
is the name of the [Input Elle [IN which the regutar 
expressions are to be tocated. 


0 or onto 3 
(optional) name of the file QNIQ which the Dutput of FIND 
is to appear. If you don't code the o parameters the 
output appears on file output by default.’ 
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Examples of FIND Usage 


sesefind *(0-9]3$! inzmyfilte ontozoutout 
REVERT. END FIND MYFILE => OUTPUT 


sesefind usingzpatfile inzoldfile ontozfoundit: 
REVERT. END FIND OLDFILE =-> FOUNDIT 


sesefind *'#.*#* inzecompitle 
REVERT. END FIND COMPILE 


The first exampte shows FIND tocating all tines in myfite that 
have a digit at the end of the line. The result appears on file 
output. The second example shows FIND used with ai pattern file 
patfile. The third exampie is locating atl tines that contain a *#?# 
sign followed by a run of any characters foltowed by another 't#!? 
Signe Such tines are reasonable candidates for being SYMPL comment 
lines. 


Text Patterns and Regular _Exoressions 


This discussion introduces the notation for regular expressions 
used by FIND and the CHANGE procedure in the next sectione The 
notation is terse but versatiles and has baen asplied in a number of 
pattern matching utitities. 


A text pattern can be a simpie things ltike the fetter a ora 
more etaborate construct built up from sinplie things» like the 
string format. To build arbitrary text patterns you need only know 
a few rules. 


Any litecal character» such as as is a text pattern that matches 
that same character in the text being scanned. A sequence of 
fitera!l characters iike 7926 or grabhotd is a pattern that 
matches any occurrence of that sequence of characters in a line of 
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the input. 


A pattern is said to gatch part of a text Sine if the text line 
contains an occurrence of the patterne For’ instance the pattern aa 
matches the line aabe once at position 1» the tine aabcaabc in 
two placess and the jiine aaaa in three ({overtapping) places. 
Matching is done on a tine by tine basis * no pattern can match 
across aiine boundary. Text patterns mav be gonscatenated : a text 
pattern followed by another text pattern Forns a new pattern that 
matches anything matched by the firsts Followed immediately by 
anything matched by the second. A sequence of iter’ali characters is 
an example of concatenated patterns. 


find has other capabilities - the ability to search for patterns 
that match classes of characterss that natch oatterns only at 
particular positions on a tines or that: natch text of indefinite 
length. 


To be able to express these more general oatternss we have to 
preempt some characters to represent other’ tyoes of text patterns» 
or to delimit them. For examples we use the character . as a text 
pattern that matches agny single character except a newline. The 
pattern xey matches xtys xays x?y and sinifar strings. 


The . and other reserved characters area often calied 
metacharacters. We try to choose characters which won't appear with 
high frequency in normal texts but still there are occasions when we 
want to took for a ftiteral occurrence of a netacharacter. Thus the 
special meaning of a metacharacter may be turned off by preceding it 
with the escape character a Thus a. natches a titeral periods 
and aa matches a literai at sign. 


The metacharacter € signals that the characters followings up 
to the next j] form a gharaster class» that is» a text pattern that 
matches any single character from the bracxeted tist. For examples 
CaAl] matches a or Avs {a-2z} matches any fower case tetter. 
There is a pegated shacacter class» such that [("a-z] matches any 
character except a lower case tetters, and so forth. Note that a 
negated character class never matches a newtinee The escape 
convention can aiso be used inside character ctasses if the 
character class is to contain ” or -=- or’ 9 or IJ. 


Two other metacharacters dontt match !iteral characters but 
rather match positions on the input ltine.: * natches the beginning 
of a line : “abe is a pattern that matches abe ogniy if it appears 
as the first three characters of an inout tine. Simitartys 
$ matches the newline at the end oF a fine 3: abcs 
matches abc only if it is the tast thing on a tine before the 
newline. Of course these can work together : “abc$ matches a fine 
that contains only abe», and “$ matches onty emoty lines (tines 
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containing only a newline). 


Any of the text oatterns above that match a single character 
{everything but “ and $) can be followed by the character * to 
make a text pattern which matches zero af. mete successive 
occurrences of the single character pattern. The resulting pattern 
is called a glosuree For exampies a*® matches zero or more ats; 

aa*®* matches one or more ats; Ca-z}]* watches any string of zero 
or more lower case ftetters. 


Since a closure matches zero or more instances of the oatterns 
which do we pick if there's a choice? [t turns out to be most 
convenient to match the Longest possible string even when a null 
string match would be equaily valid. Thus Ca-zA-Z)* matches an 
entire word (which may be a null string)s Ca-zA=Z71fa-zA-Z2]* matches 
an entire word (one or more tetters but not a null string)s and .* 
matches a whole tine (which may be a null string). Any ambiguity in 
deciding which part of a tine matches a pattern is resolved by 
choosing the match beginning with the Uaftmast characters then 
choosing the longest possible natch at that point. 
So (Ca-zlla-z0-91% matches the leftmost FORTRAN identifier on a 
fines (.*) matches anything between parentheseass and ee*® matches 
an entire tine of one or more characters (but not a tine containing 
only a newline). 


Finallys no pattern matches across a4 line boundary. This is 
often most natural and useful», and it prevents an unwise .¥ from 
eating up an whole file. 
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17.0 TEXT MANIPULATION AND CONVERSION UTILITIES 
17.220 FIND -— FIND PATTERNS IN A FILE | 


Summacy.of Reguiar_Expressions 


The previous discussion introduced a fot of new notation for 
matching text patterns and regular expressions. Here is a summary 
of what went before, 

c diteral character ( for examples ) 

° aby character except newline 

beginning of Line 

$ end of line ( null string before the newline ) 

Leee). character class ( any one of these characters ). for 
examples Cijkimn] matches the first character of a Fortran 
integer identifier. 

C200] negated character class (al! but these characters) 

*. closure izero or more occurrence of previous pattern) 

ac escaped character (for examptes 3%s 9%» af» a*) 


Any special meaning of characters in a text pattern is fost when 
escapeds inside a [eesel}s or for 3 


= not at beginning 
$ not at end 
* at beginning 
A character class consists of zero or nore of the fottowing 
elements, surrounded by C€ and ] 3 
c litera! characters including [£ 
a~c range of characters (digitss tower or upper case letters) 
negated character class if at beginning 


ac escaped character ( a”% a= daa 31°) 


Special meaning of characters in a character class is fost when 
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escaped or for 3 


not at beginning ( for example Ca”9 Jug] ). 
- at beginning or ends for example [-+2:21] or ([+4+2abc-] 
Note : the folftowing three substitution eatterns apptiy to the 


CHANGE utility described in the next section. A substitution 
pattern consists of zero or more of the following elements 3: 


c literal character 
& dittos that iss whatever was matched 
c escaped character ( a& ) 


An escage sequence consists of the character 23 =followed by a 
single character 3 


an newline 
at tab 


ac ec { including @2 ) 
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CHANGE changes patterns in a file. The from and to patterns may 
be specified on the contro! statements or they may be given as the 
first two lines of an argument file. Both from and to must be 
specifieds or a pattern file may be given via the with or using 
parameter. If none of these parameters are supotieds CHANGE takes 
its pattern argument from file input. Paraneters to CHANGE are 3 


jor f : 
name of Input Eile which is to have its ponatterns changed. 


from : 
(optional) character string which reoresents the from string 
to be matched. 


{optionai) character string which represents the to 
substitution string. 


with or using : 
(optional) name of a file containing the from and to. 
patterns on two separate lines. This file is used if there 
are lower case patterns In the fron or’ to voarameters which 
cantt be entered via the control statenent.. 


onto or o : 
{optional) name of file to receive the Qutpoput from CHANGE. 
If you don't code the o parameters the output appears on 
File output by default. 


Exampties of CHANGE Usage 
sesechange myfile from **C0-5]#* to "24ARK2E* onto outfite 


REVERT. END CHANGE MYFILE -> OGUTFILE 


ses.echange oldfite using patfite 
REVERT. END CHANGE OLOFILE 
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The first example shows CHANGE locating all tines that have an 
arbitrary number of digits between 0 and 5 at the beginning of the 
lines and changing the pattern so found into the string *=MARK=t 
followed by the string of digits that was found. [The second example 
shows CHANGE operating on a files where the pattern arguments are 
supplied via the argument file patfile. 
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17-22 XLIT_=-_TRANILITERATE CHARACTERS 


XLIT transtiterates characters in ae file. The from and to 
patterns may be specified on the contro! statements or they may be 
given as the first two lines of an argument fite. Both from and to 
must be specified» gr a pattern file may be given via the with or 
using parameter. If none of these parameters are supplied XLIT 
takes its pattern argument from file tnowt.! Parameters to XLIT 
are ? 


i or f 3 
name of Input Eile which its t9 have its characters 
transtiterated. 


from : 
{optionai) character string which represents the from string 
to be transliterated. 


to 3 
(optional) character string which represents the to 
transliteration string. 


with or using ; 
{optional) name of a Fite containing the from and to 
patterns on two separate tines. This file is used if there 
are fower case characters in the fron or to parameters 
which cantt be entered via the control statement. 


onto or o: 
(optional) name of file to receive the Qutput from XLIT. 
If you don't code the o parameters the output appears on 
file output by default. 


Examples of XLIT Usage 


sesextit myfile from *ABCDE*® to "VWXYZ!" onto outfile 
REVERT. END XLIT MYFILE => OUTFILE 
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sesextlit oldfite using patfile 
REVERT. END XLIT OLDFILE 


aummary of XLIT_ Capabilities 


This is a short summary of the facilities orovided by XLIT. The 
examptes below just show the from and to oatterns. The simptest 
form of XLIT is to simply convert one character to anothers tike : 


from x to y 


and have all occurrences of Ke in the input File be replaced by y 
in the output file. Multiple transtations are also handy : 


from xy to yx 


changes ail x's into yts and ali yts into x's, There is also 
a nice shorthand notation 


from a-z to A-Z 

to translate all flower case letters to upper cases or 
from a-ZA-~-Z to A-Za-z 

to do case reversal. Even good typists prefer 


A-Z a~-z 
to 
ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghi jklanopar'stuvwxyz 


There are times when we would ftike to translate a whole class of 
characters into just one characters and then ts collapse runs of 
that transtation into just one instancee For exanples translating 
spaces» tabs and newlines into newlines and than collapsing multiple 
newlines teaves each of the words in a docunent on a separate lines 
ready for further processing. Dr we wight want to convert ali 
alphabetic symbols in a program into a's and ail numbers 
into ntse We specify this collapsing operation by giving a second 
argument that is shorter than the first : 


from a-za-Z to a 
from 0-9 to n 
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The implication is that the last character in the second argument 
{the to string) is to ba replicated as often as necessary to make 
a string as tong as the first arguments and that this repticated 
character should never appear twice in succession in the output. 


xfiit also provides an escape convention for’ writing tabs and 
newlines so that they are visible and cause a mininum of grief for 
programs that must inspect the arguments. We use the at-sign 9 as 
an escape character : whatever character follows the escape 
character is in some way special. In particulars we define at to 
be a tab and an to be a newlines so we can write 3 


atan an 


to change all occurrences of “whitespace” [(spacesSs tabs and 
newlines) to just one newline and leave one word ver line. 
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18.0 MISCELLANEOUS USEFUL GOODIES 


This section covers a number of useful SES procedures that fall 
into no other category than miscellaneous. The facilities in this 
section are described briefly here. 


IAF sets up IAF terminal defauits for’ soecific terminal types. 


AUTOMOD automatically modifies deck names on a MADTFY library from 
the standard 170 length of 7 characters or tess to NVE 
allowabie length of 31 characters or less.’ 


DG a "control statement generator™ that. can optionally 
generate a batch job "on the fly”. 


MATH a quick and dirty desk calculator. 
BELL rings the beil as an attention getter. 
BYE fogs out your current interactive session.! 


HEXDMP produces a hexadecimal dump of a (binary) file. 


CONCAT concatenates a list of files into a sinaqte files with the 
resulting file "packed™ into a sirgie "ftogical record”. 


SCATTER performs the reverse action of CILLECT» that is it 
"scatters" a multi record file to a number of individual 
files. 
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18.1 JAF. =_SET_UP_INITIAL_TAF_TERMINAL. PARAMETERS 


The IAF procedure defines your terminal to the NOS IAF facility. 
In additions it will notify you of MAILBOX messages» and updates to 
SES.INFO. 


There are defaults for all the differant terninal typess and 
normaltys the user onty specifies his/her’ terminal type either on 
the proc call or in his/her PROFILE. Ait the strange parameters» 
including the terminal types may be set up in your profile. As an 
examples if you're logged in to a CDC 713 terminals you can set up 
the terminal controls by simply typing :. 


seseiaf term=cdc713 


The table on the next page describes the parameters for IAFs the 
defaultss and the profile variables that you can set to change the 
defaults chosen by the IAF procedure. 


Note : white the IAF procedure is runnings d2 not hit carriage 
return (CR) to find out what's going ons even if it does seem 2 
fittie stow. At the time of writings due to the way the NOS TRMDEF 
command workss hitting a carriage return interferes with the TRMDEF>, 
which will issue a tine of garbied data to your terminals, and the 
TRMDEF command gets ignored. In other wordss the IAF procedure 
wontt do anything. 
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oe ee ee eee ee eee ee eee ee ee a 00 cans same tee cen eae mae sae 
H ; ; H 
; Pacametec : Default + Profile : Parameter 
; Name i Values + Vaciable : Usage 
ae AO Oe oe ce eee eee ee em ce ee eee fe nee cam am aa ae aoe ane me nen see sm ie at fe ere em cam cote ane ae ae cee ste ee ene 00 a a A A nam a Ee OD TON A ee soe ee se ae se web cae se 
terms t : No Default ¢ term 2 Terninal tenes For a 
H ; + fist of the terminal 
; ; : typas currentty 
H ; $ racognized by the IAF 
; ; ; oroacedures see the tist 
; H H en the end of this table. 
ee ee ae ee ae ne en eee he ae een ee eee eee ene one} ee ae we ee ae ee ee he re 00a ne ee ee we aah ae sate aoe ee same se sa eae asm om oe eee 
intchrs ic $ see below 3 pitenr H Sia aktee to INTERRUPT a 
; ; +; Or ocesss 
ee nn fh ee an fe re ft rr en nnn n= 
“Meemenr: tc {| see below ; termchr i! Character to TERMINATE a 


; : $ orocesss 
a oe ae ae ae ae ce ae ee ae coe ee cee ae coe ae ae ee ee a see see a ee ee fp soe ae ne cae sae sate san ate ae wae he ED A OO A -  D  ie eD a E ne e ate e 
canchrs ce i; see below ; canchr $ Character to CANCEL a 
: line input at the 
H terninal. 
oe ce ae ee eee oe oe ee ne oe oh Se ee ee ae ae ae ee ee 


conchrs ct :; see below 
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i 
i 
4 
i 
i 
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' 
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j 
! 
i 
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ce | 
ame | 
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pp we Oe oe ae op oe ae Oe om } on we oe hb oe oe 6H om hb we we we fh om oe He ee Oe tp om wk ee dh Oe we comes oe ae we Oe we oe we oe we 


nina heter 6 use as a 
CINTROL character when 
Giving conmands (such as 
age wait =on or off) to 
h 


pon ee ee OO Oe hy we ae 


> Gb he eb <n ER A D a ee De 


bschr» bs 


A a RP eee eA HE ae Ge 


see heiow 


i 
' 
i 
i 
i 
i 
' 
i 
i 
1 
‘ 
i 
i 
\ 
‘ 
i 
i 
' 
i 
' 
t 
' 
i 
{ 
i 
j 
‘ 


H ohareecter to use to 

3} dalete previous input 

; character.’ 

ee See ee ee ee 
width + Determines maximum number 

$ of characters a terminal 

$ can print on one output 

i tine. 

ee Se ne SE ee ee eee See te 
lengths, ten i: see below : ftength +; Determines maximum number. 
of tines that can be 
peRORES as one pages 

hetacnt nes whether page 
waiting Is to be 

performed for the 
terminal. 

ae ae ae ee ee ee oe oe a ee ee of eee ae ee eee ee ae wee ae ct eee oe of a ee aw te ee ee eae tn sae fh ee ne ee e-em ae ae oe ate ln an Oe ae ce ee a a ee ee me ee eae 
half/full : full dupiex $ Determines whether your 

terminal is to run in 

HALF or FULL duplex. 

; These are just keys. 


widths pw 


a a en eee oD ee ee 0 ee ee 


see below 


ee ee ee ee ee et a 
' 
' 
' 
| 
! 
t 
! 
! 
{ 
t 


oe Se we te hh we we we - 28 ee we oe be 


ab ED A A ON ab YD aD ee ee eee aD 


pgwaits pg 


AD YA A CN DE AD OD ED ee eee ie ae an ee aD Gee cline ene wine wee 


de ee wh we op we ok oe 


Pm 
oO 
ee we 08 es Gq on ae 
cS 
; © 
Ps 
Pd 
ee 
fad 
oe nae *©2 we + ae on oe 


aoe @e 28 oe 
we en @ 


pee we Oe 6H we Oe Oe oe } oe be Ob > an 6 wee oe oe oe Ho oe HE oe OH Oe eH ae Oe we Gore Gas re eee 
or ee ie 
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; ci ; 0 ; cl 3 Carriage return idie | 
; ; ; : count For IST3 or TI745. 3 
fe ee a nf a a a ee fe ee ne fe enn 
2 ti : 0 > i + Lire feed Idle count for 3} 
3 H : + IST3s TY745 or CDOC751. H 
dp a af ee ne fn ne fn oe on 
: hardcopy ;. no : hardcopy |: If you use aiehardcopy 3 
H H ; ; device on your I[ST3s5 the 3 
H H H ; defautts for ci and li i 
: ; H * are changed to 50 each, ; 


The defaults given aboves namely “IAF default", are those chosen 
by IAF (part of NOS)» as opposed to [AF (the SES procedure). We 
have copped out by not stating what they are heres since they change 
from time to time. For a tist of the defauttss consult the IAF 
reference manuals or see your local NOS wizard. 


The term (for terminal) profile variable is set up when you use 
BLOPRDOF (BuilD PROFile)s» and the IAF procedure uses this profile 
variable. If you use the IAF procedure and 19 terminal type is 
specifieds, either via the term parameter or the term profile 
variable, IAF prompts for the terminal type. You: can edit your 
profile to insert all the other defauits if you wish. 


Terminal types that the IAF procedur'’e knows about at present 
are 3 


COC713» CDC722»5 COC7T22As COCT51, CDC752» DX132As DNC300s DATAPATC, 
NCR6O20»s TI745s TTY43s DECW3» TEK4014» IST3»5 CDC721»5 719. 
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The table befiow describes the control characters and other 
parameters that the IAF procedure establishes for you. Note : that 
a page width of zero (0) allows the maximun sage width. 


fe af nn mf an na fo ne fo wn fn np ee nf on pe nnn panne t 
STERM— ‘CONTROLICANCELSINTER-?} TERM— $ BS {PAGE TPAGEI PAGES ECHO— 
sINAL CHAR ¢ CHAR iRUPT TINATE § CHAR SWIITHILEN SWATTIPLEX 
i TYPE : sCHAR = $CHAR : : ; +MODE 
& 7 * H * 4 * ; * } * % *& 3 * | * 


a 
% 
3 
% 
3 
4 
3 
a 
: 
s 
a 
+ 
a 


eh ie a ate 


3 
a 


3CDC713 ESCAPE $LINE iSTX sETX ?BS ; 9 ¢ 16 3 N FFULL 
H ' :CLEAR 3 ; H ; H : H 
fm eh ha nf en hf nf wn fn fon nn 


$COC722 FESCAPE {EOL sCTRL/PSTAB 3 BS >; O $ 24 $ N GFULL 


sCOC722Z2ASESCAPE EOL tCTRL/PSTAB 3 EM $ 29 $ 24 3 N FULL ¢ 


3CDC751 FESCAPE $6GS SCTRL/PICTRL/TIBS + O 3 24 $ N GFULL } 
$e rn anf a nn af nn = fe nf an fe net np ne to nn tn + 
CDC752 SESCAPE SCTRL/XSCTRL/PSCTRLITIBS > 9 $ 24 3 N SFULL 3 
3Z19 H : ; : : ; H H ; 
fren fp en nf enn am fn rn nn fe nn fen ap on nh on pn nn f+ 


1DX132A i % SCTRL/XICTRL/PSCTRLITIBS + 132 3 30 3 N SFULL 3 


$D0C300 ESCAPE $VT {FF tHT  fCTRL7HE 118 $ N/A$ N/ATFULL $ 
fe ap en anf en fe a fp en ef nn nh nn fp ttn tnt 
TDATAPACTESCAPE SCTRLIXECTRL/PSCTRL/TICTRLIHi 89 «§ NZAT N/ASHALF $ 
$n rn a fo nn wm ff en rn fe rn of ne ef nn on} en nf ee nf on fon + 
sNCR260 3 H H ; : ; : : 
271745 H H H 
sTTY43 
DEC WS 


] 

i] 

8 

ESCAPE iCTRLIX$ sCTRL/PS {CTRL /TECTRLTH! N/ASFULL 3 
a 

a 


op =e 38 we ae 
o 
we 


oh aa ae we we 
- of «a ow 


> = 
' 
j 
{ 
‘ 
! 
' 
' 


! 
' 
' 
| 
i 
i 
ao 
! 
{ 
1 
' 
t 
( 
+ 
' 
| 
' 
| 
i 
5 
oe + 
i 
t 
' 
t 
t 
j 


‘a <b web a ep 


 TEK40141 ESCAPE CTRLIX! CTRLIPS CTRL/T! CTRL IM! 9 N TFULL 


: 
a 
a 
: ] 
a 

m-me aoe mee 
a 
a 
H 
+ 
a 
a 
+ 


op ot 48 oe we 


PS 


#COC721 YESCAPE ECTRL/KECTRL/ PECTRLITICTRL/HE 0 $$ 30 N FULL ; 


11813 tESCAPE ECTRL/X} ECTRL/PECTRL/TECTRUTY: 9 $ 34 


The default values can be changed by coding a4 parameter that 
corresponds with one of the columns marked with ®. If half duptex 
is desireds simply code the half key. 


Note : when specifying an octal code to change a default values 
remember that the radixs enclosed in parentheses» must follow the 
numbers, for example 3 

conchr=33(8) 
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Note : character values can be changed by entering the desired 
character enclosed in string quotes (apostronhes)s instead of octal 
Numbers e 
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18.2 AUTOMOD = AUTOMATIC MODIFY TO_SCU_ NAME CHANGE GENERATOR 


AUTOMODO is a MODIFY ftibrary to SCU fibrary too! that eases the 
conversion process by automatically determining the 31 character 
deck names when a standard way of determination exists. The output 
of this process is a file of commands that in: turn can be used as 
input to the SCU conversion commands CONVERT LYODIFY_TO_SCU. This 
reduces the number of deck names that must be changed manually (one 
at a time). Note that AUTOMOD can potentially he unable to handte 
extisa farge tibraries. It is suggested that merety creating two 
librariess each with half the deckss should sotfve the problem. 
Parameters to AUTOMOOD are : 


bor i: 
name of Base Library containing the YODIFY decks to be 
searched for the tong namee 


Oo 3 
{optional) name of file to receive the Dutput from AUTOMDD. 
If you don't code the oo paraneter’> AJTOMOD places the 
output on the file NEWNAME. 

un 3 


(optional) User Name in whose catalog the base library 
specified by b exists. 


The program uses a simpie algorithm to do the transtation. It 
searches the deck for a procedure name with the same first two 
characters as the deck namee The SIS snoacifies the fegal types of 
decks and the coding of the short names. *9* decks do not 
consistentiy contain an identifiable choice for the tong names so no 
attempt is made to find onee '*X* decks cortain the XREF declaration 
for a procedure or function and this name is used as the long name. 
"H? decks contain a commented exptanation of the *X* deck and the 
procedure name is simply searched for and used with 'H! substituted 
as the third character to distinguish then from the tong names for 


the 'X* decks. *E* decks have not been consistentiy used for the 
same purposes but most of them end up with the tikety tong name 
anywaye 'M* decks should end wo with the tong nodule name off of 


the same line as the keyword MODULE. "A" dacks should work the same 
off of the word ASSEMBLY. 
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18.3 DO_-_CONTROL_ STATEMENT GENERATOR 


DO accepts a tist of character strings» or a file of commands» 
and outputs them to the NOS control statement strean. The stream of 
commands so generated may be submitted to the hatch system if 
desired. For example :. 


sesedo ('rewinds **s*getsamyfile's*disposesnyfilezprt,'*ses.catiist?) 
All sorts of NOS control statements may be given as parameter values 
to the DO procedure. Note that a perfectly valid 00° parameter value 
is acail on SES processor itself, so that if you were feeting 
sufficiently playfuls you could code lines !ike :) 
sesedo *sesedo **ses.ecatiist*t!? 


Parameters to 00 are : 


Tr 
“ 
+ 


(optional) list of Control Statenents to be output to the 
control statement file. 


{optional) name of file containing control statments to be 
executed. If you don't code the §° oarameters DO prompts 
you to enter the statments from file tnput.~ Coding the i 
Parameter causes DO to submit a batch job containing the 
stream of commands from the file. 


(optional) name of Library in which the text record given 
by the i parameter may be found. [The Jibrary must have a 
directory. You use this feature to oface canned streams of 
JCL (such as buitd jobs) tn a LIBEDIT sty!te library. See 
the chapter on LIBRARY FILE MANAGEMENT SING LIBEDIT for 
hints on how to manage LIBEDIT tibr‘aries. 


un 3. 
{optional) User Name in whose catalog the file given by the 
i parameters or the tibrary given by the # parameter may be 
Founds if it is not in the current useart*s catalog. 


f or fife or files :; 
{optional) list of LOCAL FILES that are to be copied onto 
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of 


the end of the job file if DO is being used to create a 
batch job lone of the batch» batchn or defer keys are 
coded). If you code any values for’ the files parameters 
DG generates the job control to COPYBF each of the local 
files onto the end of the job file before SUBMITTING it 
and also generates the control statements in the jobfile 
itself that are necessary to COPY3F those Files from INPUT 
when the job runs. If any of the filenames coded for the 
files parameter are not assigned to the job when you code 
the sesedo statements» the D0 orncedure aborts with an 
error message. 


batch job parameters 3? 


These parameters are described in tha section entitied 
"SES PROCEDURES RUN AS BATCH J938". The default for this 
procedure is to run in focal modes but it can be run in 
batch mode. The dayfilte paraneter is not used by this 
procedures 


Example of Using DO to submit a batch job 


sesedo (*sesegencomp minctud', ‘fses.cybit'>s. .% 
*seseprint tistingts "savesigo')s batch;. bye 

10.23.2562 SUBMIT COMPLETE. JOBNAME [S ABLEBI0 
REVERT. JOB 00 SUBMITTED 


The four control statements (mostiy consisting of SES orocedures 
course!) are built into aobatch job and submitted. The bye 


procedure then fogs you off. 
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18.4 MATH.=_ INTERACTIVE KEYBOARD. CALCULAIO3 


MATH is: an SES procedure that interacts with the user to provide 
a "quick and dirty” interactive calculator. Onty integer arithmetic 
of 48 bits precision is provided. 


MATH works on the concept of the current’ varlable. When MATH is 
started, it starts with a variabie called VALYEs whose vaiue is 0. 
Every time an expression is assigned to a variables that vartable 
becomes the current variable. An assignment statement with no 
variabie name on the ieft of the operator assigns the expression to 
the current variable. Type END to terminate this procedure. Vatid 
entries are 3: 


z expression assigns the value of "exoresstion”™ to the current 
variable. 


+ expression adds the vaiue of "exoreassion”™ to the current 
variable. 
- expression subtracts the value of "expreassion*® From the 


current variable. 


* expression multiplies the current variable by the value of 
"expression™ and assigns the result to the 
current variable. 


/ expression divides the current variable by the vatue of 
“expression™ and assigns the result to the 
current variable. 


// expression performs the caiculation current variabie MODULO 
"expression® and assigns the result § to the 
current variable. 


** expression raises the current variable to the power 
“expression” and assigns the result to the 
current variable. 


name = expression assigns the value of “exoression”™ to the variable 
specified by "name", which then becomes’ the 
current variable. 
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18.5 BELL _-_AITENTION GETTER OR WAKE UP 


BELL is a useful facility for those users: whs fall asleep at the 
terminal. This BELL procedure “rings the belt™ a specified number 
of times. Parameters to BELL are 3 


is the (Coptional) number of times. to "ring the bell"™,. If 
you don't code the n parameters 3ELL rings twice. 
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18.6 BYE -_LOG_QUT 


BYE is an SES procedure that sends a special cortrol code to the 
user's terminals, to log it out. This provides the useful facility 
that you can set a stream of SES procedures: goinaos with the fast one 
being BYE» and you can then walk away fron the terminal and tet the 
system get on with the job. For example, the following is a fairty 
typical sequence 3 


sesegencomp themod!s compass; print listing: "savesigo'; bye 


The example shown GENerates a COMPile file for module themodt>» 
compites it with the COMPASS assemblers PRINTS the listing output of 
the assembier, saves the binary output of the assenbler on file tqoys 
and finally togs the terminal off via the BYE procedure. The 
programmer is able to type that tine of SES orocedure caliss then go 
and have tea while it's ali happening. 
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18.7 HEXDNP_=-_ GENERATE _HEXADECTMAL. DUMP 


HEXDMP produces a printable dump of a binary File. In the dumps 
CYBER words (addressed in octal) are showr: in hexadecimal with 8/12 
ASCII interpretation. Parameters to HEXDM? are 3: 


name of the local file from which to oroduce the dump. 


0 3 
name to be used for the tocal: File containing the 
printable dump. 

por t 3. 

(optional) type of dump to produce : 
P printable - 8 words per tine for’ lf nme printer 
T terminal - 4 words per tine “For terminal output 
{default) 
aor hi: 


these (optional) keys determine if ASCIT interpretation of 
the dump is to be included in the outout. If you code the 
a key» ASCII is included - this is the default action. If 
you code the h Key (Hex only) keys ASCII is not inctuded in 
the dump. 


Exampftie of HEXDMP Usage 
sesehexdmp filel thist t 
REVERT. FILE DUMP COMPLETE 


This command creates a file "TLIST!® suitable for displaying on a 
terminal showing the contents of file "FILE1' In hexadecimal. 
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18.8 CONCAT_=_CONCATENATE FILES 


CONCAT concatenates files onto a singte “grouno” file. It is 
simifar to COLLECT except that CONCAT works with files instead of 
recordss and the resultant group file is PAC<ed upon completion of 
the process. Parameters to CONCAT are ; 


ior f : 
is a list of names of files to be concatenated onto the 


group file. 


g or group 3 
(optional) name of group file to reseive the final 
concatenated set of files. TF vou dontt code the group 
parameters CONCAT uses the vatue 9f orofille variable group» 
and if there's no such variabie defineds uses the name 
group. 


msg of nomsg : 
these (optional) keys controt the generation of 
informative messages by this procedure and are fully 
described in section entitied "INFIRMATIVE MESSAGES FROM 
SES PROCEDURES*. 


Examptes of CONCAT Jsage 


seseconcat (myfileshisfilesanyfite) 

* MYFILE => GROUP 

* HISFILE => GROUP 

* ANYFILE => GROUP 

REVERT. END CONCAT MYFILE«-eANYFILE =-> GROUP 


seseconcat (grabshotdsgripscliutch) gztitefins nomsg 
REVERT. END CONCAT GRABee CLUTCH => TITEFIN 


18-15 
COC = SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook REV: 4A 
18.0 MISCELLANEQUS USEFUL GOODIES 
18.9 SCATTER =—- SCATTER A AULTI RECORD FILE TO OTHER FILES 


18.9 SCATTER = SCATTER A MULTI RECORD FILE _TI_LITHES_ FILES 


SCATTER copies the records of a multi record fille to a number of 
other files. Parameters to SCATTER are 3: 


moor f 3 
fist of names of Eifes or Member files to which the records 
of the singte file are to be copied. Names may appear iin 
the tist more than onces if you want to divert sundry 
records to the same file. 


g ot group : 
(optional) name of GROUP file containing the records to be 
copied. If you dontt code the g parameters, SCATTER uses 
the value of profile variable groups and if therets no such 
variable defined» uses the file nane grous. 


if you code this {optional) keys SCATTER does gqggt rewind 
the group file before starting the conoy sequence. If you 
don*t code the nr keys SCATTE2 rewinds the group file 
before doing any copying. 


Exampies of SCATTER Usage 


sesecataiog newprox 

GETPXDB.eTEXT TOOLDOC TEXT GETMAILAS TEXT COMPARE. -TEXT 
GENCORS ee TEXT GENREVB oe TEXT CAPSSIF TEXT 

REVERT. END CATALOG NEWPROX 

sesescatter (cerbicsvarnelstaviotscerbicsvarnelscerbicsfootie) secceos 
ee? gzenewnprox 

REVERT. END SCATTER CERBIC.-FOOTLE <- NEWPROX 

sesecatalog cerbic 

GETPXOB.eTEXT COMPARE « eTEXT GENREVB TEXT. 

REVERT. END CATALOG CERBIC 

sesecataiog varnel 

TOOLDOC .- TEXT GENCORS ee TEXT 

REVERT. END CATALOG VARNEL 


The example shows how SCATTER Is used to separate the records 
from the file newprox onto the different files given in the ftist on 
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the SCATTER catl. The CATALOG procedures are used here to show the 
“hefore and after™ effect of SCATTER. 
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19-0 HANDLING UPDATE PROGRAM LIBRARIES 


For those who use UPDATE as the source text maintenance’ regime 
for software developments the set of SES orocedures described betow 
supply a fairly easy to use interface to JPDATE. A short summary of 
these SES procedures appears first, with the more detaiited 
descriptions following. The SES procedures to drive UPDATE are as 
follows 3 


GENUPCF GENerate UPdate Compile Eile. Generates a compile file 
for specified decks with modsets optionally applied. 
Either a Quick mode or Full mode JPOATE can be performed. 


GETDECK GEI DECK(s) for editing. This is intended as a 
preliminary to a GENMDD(S) orocedure usage in order to 
generate modsetses 


GENMOD({S) GENerate MODification Sets for deerks on a PL. GENMODS 
uses the SCOOP utility to compare two files and generate 
UPDATE modification directives. 


GENUPSF GENerate UPdate Source Eile. A source file may be 
generated for specific decks or conmon decks» with 
modsets optionally applied. 


UPDATE applies a tist of modsets to an 31d orogram tibrary and 
creates a new program library. 


19-2 
COC —- SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: 4A 


1920 HANDLING UPDATE PROGRAM LIBRARIES 


PROFILE Variable for UPDATE Facilities 


The update procedure interfaces use onty three orofile variables, 
but these are of great utility when you're working on the same PL 
for long intervais. The profile variabies: are : 


oldpl name of the program library to be used when generating 
compite files» edit files and so on. [t Is the default for 
the pl or oldpti parameter on the orocedures. 


newpi name of anew program library «hen rurning the UPDATE 
procedur ee It is the default for 
the api or newp!l parameter on the UPDATE procedure. 


plowner PL OWNER is the user name of the catalog in which the 
program library resides. It: is: the default § “for 
the un parameter on all the procedures. 


updtmcc UPDale Master Controt Character. If you're working with 
such things as tstash PL'st, this profile variable is 
useful for overriding the standard naster control character 
which is the asterisk (*) character. 
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1920 HANDLING UPDATE PROGRAM LIBRARIES 


Working with the UPDATE Procedures 


In order to get the best use out of the UPDATE interface 
facilitiess it is anticipated that users will Follow the set of 
working procedures outiined below. 


o Most of the procedures work on the conceot of applying modsets 
to an existing program tibrarys and onty making a new program 
library at fairly infrequent intervalss say once every two 
weeks or SOe This allows many ofopte to be working on 
unconnected decks at a times with one person —controlfing the 
building of new program tibraries. 


o To make modifications to a decks use GETDECK to generate an 
EDIT FILE (ptus a COMPILE FILE); edit the edit files then use 
GENMOD(S) to generate modsets which can then be used in 
subsequent GENUPCF runs. 


o To make major changes to deckss use SENUPSF to get the source 
of the deck outs and edit that. 


The working scheme suggested here has been in uses successfully» 
for some time. It is far easier to comprearerd and handie than it ts 
to be 'manually' creating correction sets. Pictoriallys the scheme 
fooks something like this 3 
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ee | oe | 
/ It : 
tomeen mea + | teem nn newt } 
: 1 : | 
$ GETDECK {--------- EDIT FILE -------> 1! EDIT $4 
: : : a 
a ee. femme map mm mnt 
: : 
: : 
COMPILE $—----------+ EDITED 
FILE / nn FILE 
: tona--------+ |} : 
: _ 3 2 i<-------- ----+ 
te-—--------->) GENMODI(S) ¢$ + 
: 7 
ee eo 


; 
MODSETS 
8 
j H 43 
teonn—------4 | NEW 
$ —--------. COMPILE ----> 
GENUPCF ¢: + FILE 


r 

r) 

a 8 
® ‘ 
+ 


To show how this goes In practices on the next page therets = an 
exampie of a complete session of work involving the three widely 
used procedures GETDECKs GENMOD{(S) and GENUCCF. We want to generate 
modsets for decks “delta™s and “mnu® through "ohi"®. User typing is 
in flower cases and NOS messages in UPPER CASE. It is assumed that 
the program tibrary ~- PROGLIB - is specified in your profile. 
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sesegetdeck d=(deltasmue.phi) 

* GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EOTFILE 

REVERT. END GETDECK EDTFILEs COMPILE <= PROGLIB 


edit,sedtfile 
editing 
session 


_ 29 @ 


EDITs»EDTFILE 


sesegenmods anymods jan0879 cd=(deltasmu..dhi) 
REVERT. END GENMOD COMPILE:EDTFILE => ANYMODS 


ses.egenupcf anymods 
* GENERATING COMPILE FILE COMPILE 
REVERT. END GENUPCF COMPILE <=- PROGLIB 


As you can see from the examples the amount of tyning you do is 
smatis there are in fact onty four commands Cexcluding the actual 
edit session commands)» the system does the rest. 
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19.1 GENUPCE > GENERATE_UPDATE COMPILE FILE’ 


GENUPCF generates a compile file for any sneciflied decks on an 
UPDATE program library. Modsets can be apotied also. Parameters to 
GENUPCF are 3 


moor mods ;3 
is an (optional) tist of names of Files containing modsets 
to be applied against the PL when generating the compile 
file. One or both of the mods oaraneter and the a 
parameter must be specified. 


d or all : 
is an (optional) tist of deck names to be piaced on the 
complie file. If the all’ key Is codeds this implies a full 
update in which case nag deck 2anes should be specified. 
One or both of the mods and the d parameter gust be 
specified. 


oe 


cf 
(optional) name of the file to receive the Compile File. 
If you don't code this parameters the comoifte File appears 
on a file catted compite. 


pi or oldp!i : 
(optional) name of the UPDATE progran ttbrary from which to 
generate the compite file. If you don"t code the pl 
parameters, GENUPCF uses the value of ornofile variable oldp! 
as the name of the program tlibrary» and if there'*s no such 
profile variabte defineds uses the name oldpl. 


un 3 
{optional) name of user in whose catalog the program 
fibrary residese If you don't code the un parameters 
GENUPCF uses the value of profite variabte plowner (PL 
OWNER) as you names and if there's no such profile variable 
defineds GENUPCF uses the name of the current usere 


status or sts : 
these f{optional) keys are used for those cases where 
GENUPCF is being used as a building btock of aéetarger 
procedure. The NOS job control register EFG is set to zero 
{0) in the event of a successful comotletions and to non 
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zero if the UPDATE process bombs for any reason. If status 
is not specified and an error occur’ss the procedure EXITs. 


msg or nomsg : 
these (optional) keys contro! the generation of 
informative messages by this orocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES", 


ac 3 
(optional) Master Character to 562 used instead of the 
standard master character (*). If you don*t code the ac 
parameters, GENUPCF uses the value of orofile variable 
updtmcc,s, and if there's no such orofile variables uses the 
default master character asterisk (*). 


Examples of GENUPCF Usage 


sesegenupcf modfilte 
* GENERATING COMPILE FILE COMPILE 
REVERT. END GENUPCF COMPILE <= MOLDPL 


sesegenupcf m=(modslsmods2)» d=(alidigswhitessdefines)»s plzanyp! 
* GENERATING COMPILE FILE XPANDED 
REVERT. END GENUPCF XPANDED <= ANYPL 


The first example shows the simplest usage of GENUPCF to generate 
the default compile file compite from a source program tibrary 
called moltdpi (Master QLOPL) whose name is oresumab!ty defined in the 
user's profile. The compile file is gererated by applying the 
modsets in the file modfitle. 


The second example shows a stightly nore complicated situation 
where you are applying a tist of madsets and svoecifying a tist of 
decks to be placed on a compite file calied xpanded. The compile 
fite is to come from a source program Itbrary called anypl. 
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19.2 GEIDECK - GET DECK(S) FOR EDITING 


GETDECK is used to produce two files from an UPDATE program 
library : a compile file with sequence numbers and an edit File 
without sequence numbers. The edit file Is: attered using an editor 
or suchlike. The two files can then be used as inputs to GENMOD(S) 
to produce UPDATE correction sets. Parameters to GETDECK are : 


moor mods 3 
is an (optional) fist of names of Files containing modsets 
to be applied against the PL when generating the compile 
and edit files. One or both of the mods parameter and the 
d parameter myst be specified. 


d or decks or c or coms or all. 3 
is an toptionai) tist of deck or° conmon deck names to be 
placed on the compile and edit files. If the all key is 
codeds this impties a full uosdate In which case no deck 
Names should be specified. One or both of the mods and the 
d parameter and the mods parameter’ nust be specified. 


(optional) name of the file to receive the Edit Eile. If 
you don't code this parameters the adit File appears on a 
file called edtfile. 


pl or oldpli :; 
(optional) name of the UPDATE orogram tibrary from which to 
generate the compile file. If you dontt code the pi 
parameters GETDECK uses the vatue of orofile variable oldpt 
as the name of the program Jlibrarys and if therets no such 
profile variable defineds uses the name oldp!. 


un 3 
(optional) name of user in whose catatog the program 
library resides. If you don’t code the un parameters 
GETDECK uses the vatue of profile vartabte plowner (PL 
OWNER) as you names and if there's 19 such profile variable 
defineds GETDECK uses the name of the current user. 

cf : 


{optionai) name of the file to receive the comvoite file. 
If you don't code this parameters the conoile file appears 
on a file called compile. 
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19.0 HANDLING UPDATE PROGRAM LIBRARIES 
19.2 GETDECK - GET DECK{S) FOR EDITING 


status or sts : 
these (optional) keys are used for those cases where 
GETDECK is being used as a bultding block of a larger 
procedures. The NOS job control register E&G is set to zero 
(0) in the event of a successful completions and to non 
zero if the UPDATE precess bombs for’ any reason. If status 
is not specified and an error occurss the procedure EXITs. 


msg or nomsg : . 
these (optional) keys control. the generation of 
informative messages by this procedure and are fully 
described in the section entitled "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 


(optional) ‘Master Character to be used instead of the 
standard master character (*). If you dort code the mc 
parameters SGENUPSF uses the value of profile variable 
updtmecs and if there's no such profile variables uses the 
default master character asterisk (*). 


Exampie of GETDECK Usage. 


sesegetdeck (listsofstodayssmodsetssto,s apolysagainststhespi) 
* GENERATING COMPILE FILE COMPILE 

* GENERATING EDIT FILE EDTFILE 

REVERT. END GETDECK EDTFILEs COMPILE <= SOLDPL 


This example shows a whole raft of modsets apotied to a program 
library whose name you defined as SOLD®L (§uoer QLDPL) in the 
profile. The compile file and edit file names take their defaults 
of compite and edtfile. The edit file edtfile nay now be edited to 
provide a basis for a GENMOD(S) run to generate sone more modsets. 
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1923 GENMOD ($3) _=_ GENERATE MODSETS_FOR_ UPDATE: 


GENMOD(S) uses the SCOOP utility to compare two files - a new 
file and an old compile file with sequence nunbers - and produce an 
UPDATE correction set which can subsequentiy be used by the other 
UPDATE interface procedures. Parameters to SENYOD(S) are 3s 


m or mods 3: 
{optionai) name of file to receive the generated modsets. 
If you don*t code the m parameters SENMID(S) places the 
generated modsets on a file catled modsets.’ 


ior id or ident ; 
(optional) name of the IDENT to anoear as the first line of 
the generated modsets. If you dontt code the ident 
parameters the ident name defaudts to that of the file 
specified by the m parameter. 


c or cd: 
(optional) Compile Directives are the nameis) of decks) to 
be compiled when the modsets are eventually applied in a 
compile file generation. Ranges af decks may be specified. 


hoor new : 
(optional) name of the NEW file (the edited file without 
sequence idents). If you don't code the new parameters 
GENMOD(S) uses edtfiles which is the default edit file name 
generated by GETDECK. 


oor old : 
(optional) name of the OLD file (connoile file with sequence 
idents). If you don't code the old parameters GENMOD(S) 
uses compiles which is the default comoite file name 
generated by GETDECK. 


mc 3 
(optional) Master (Character to be used instead of the 
standard master character (#). If vou dos*t code the ame 
parameters GENMOD(S) uses the value of profile variable 
updtmcecs and if there's no such orofile variables uses the 
default master character asterisk (*), 
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Examples of GENMOD(S) UYJsage 


sesegenmods metoday id=jan08 cd=(deckasdek4ast) 
REVERT. END GENMODS COMPILES EDTFILE => TODAY: 


sesegenmods tuesday jan09 newzgood old=broken. 
REVERT. END GENMODS BROKEN?GO0D —> TUESDAY 
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1944 GENUPSE =-_ GENERATE UPDATE SOURCE FILE 


GENUPSF generates a source file for any soacified decks on an 
UPDATE program Jtibrary.e Modsets can be aooslied also. Parameters to 
GENUPSF are 3; 


mor mods : 
is an (optional) list of names of files containing modsets 
to be applied against the PL when generating the source 
File. Qne or both of the mods oarameter and the d 
parameter must be specified. 


dor decks or 

c or coms or 

alideck or alltcom : 
is an (optional) list of the things to be piaced on the 
source file. dor decks is a tist of DEC<S to be placed on 
the source file. coor coms is a list oF ZOMMON DECKS to be 
piaced on the source file. Coding the altdeck or the 
allcom keys indicates that a full mode update is to be 
performeds in which case ng deck aanes should be soecified. 
One or both of the mods and the decks parameter must be 
specified. 


sf 3: 
(optional) name of the file to receive the Source Eile. If 
you don't code this parameter, thea source file appears on a 
file called source. 


pi or oldp! : 
(optional) name of the UPDATE program library from which to 
generate the source file. If you dontt code the pi 
parameter, GENUPSF uses the vatue of profite variable oldpt 
as the name of the program library, and if there's no such 
profile variable defineds uses the name oldpt. 


un 3 
{optionat) name of user in whose catalog the oprogram 
library resides. If you dontt code the un parameters 
GENUPSF uses the value of oprofife vartabte ptowner (PL 
OWNER) as you nmames and if there's no such orofile variable 
defineds GENUPSF uses the name of the current user. 
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status or sts 3 
these foptional) keys are used for those cases where 
GENUPSF is being used as a building block of a larger 
procedure. The NOS job control register’ EFG is set to zero 
(0) in the event of a successful connplietions and to non 
zero if the UPDATE process bombs for any reasone If status 
is not specified and an error occurss the procedure EXITs. 


msg ofr nomsg ? 
these (optional) keys control: the generation of 
informative messages by this o2rocedure and are fully 
described in the section entitied "INFORMATIVE MESSAGES 
FROM SES PROCEDURES". 


mc ? 
(optional) Master Character to b2 used instead of the 
standard master character (*). If you dontt code the me 
Parameters, GETDECK(S) uses the value of orofile variabie 
updtmccs and if there's no such orofile vartabies, uses the 
default master character asterisk (*). 


Examples of GENUPSF Usage 


~ 


sesegenupsf cz'git$mes!» pi=z=mcspls unzjejo1)2 
* GENERATING SOURCE FILE SOURCE 
REVERT. END GENUPSF SOURCE <= MCSPL 


sesegenupsf (modsonesmodstwo)s dz=deckone.edecktwos sznewfile 
* GENERATING SGURCE FILE NEWFILE 
REVERT. END GENUPSF NEWFILE <= OLDPL 


_The first exampte shows GENUPSF used to place a common deck onto 
the source file (which defaults to source since it wasnt 
specified). Note the use of string detiniter’s (*) because the 
common deck name git$mes has a $ stan in ite Also in this 
example both the program tibrary name and user name where it is to 
be found are specified. 


The second example shows a pair of modsets being applied to the 
program tJlibrary calied ofdp!? in order to ganerate a source file for 
a range of decks deckone thru decktwos with the source file 
appearing on a file called newfile. 
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19.5 UPDATE =_UPDATE. PROGRAM LIBRARY WITH VIRRECTION SET(S) 


UPDATE applies a tist of modsets against an otd program =tJlibrary 
to produce anew program tibrary in UPDATE format.: The old and new 
program tibrary names can be the sames in which case the old program 
library is rewritten. Note : that progran library creation is the 
oniy function performed by this UPDATE orocedure - simultaneous 
compile File generation is not done. Paraneters to UPDATE are 3 


mods or m 3 
fist of one or more file(s) containing the MODification 
Set(s) to be applied against the orogram tibrary specified 
by the pf parameter. 


pi or oldp! : 
{optional) name of OLD Program Library to be updated from 
the correction set file. If you don*t code the pl 
parameters, UPDATE uses the vatue of profile variable oldpt 
as the name of the program librarys and if there®s no such 
variable defineds UPDATE uses the default name oldpl. 


npi or newpl : 

(optional) name of New Program Library to be created when 
the update has been compteted. If you: don't code the nplt 
parameter, UPDATE uses the vatue of orofile variable newpl 
as the name of the new program Iibr'arys and if therets no 
such variable defineds UPDATE writes the new program 
library over the old program library svecified by the pl 
parameter. 


un & 

(optional) User Name in whose catalog the program tibrary 
specified by pi/npt is to be founds if pl/nplt is not in the 
catalog of the current user. Tf you don'tt code the un 
parameters, UPDATE uses the value of oprofife variable 
plowner as the user name fron whose catatiog the program 
fibrary Is to be obtaineds and if there*s no such variable 
defineds UPDATE uses the current user's catalog. 


lock or nofock : 
these (optional) parameters deternine whether the program 
fibrary update process is interlocked against simultaneous 
updates; coding a filename for the tock parameter 
determines the name of the interlock fits. Interlocking is 
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status 


msg or 


the default action when the progran library being updated 
is in another user's cataltoge. If you dorwit code either of 
the lock or notlock keys» interlocking is controlled by the 
lokmode profile variable. Refer’ to the introductory 
sections of this chapter for’ information on the 
interactions of the ltokmode profile variable and the lock 
and nolock parameters. If you dor*t code ai filename for 
the fock parameter, the contants of profile variable 
intrlok is used as the interlock Filenames if there's no 
such profile variables the name intr‘lok: is used as the tock 
filename. The interlock file must be in the same catalog 
as the program library being uodated. If the interitock 
fite cannot be founds the procedure abortse. 


or sts : ; 

these (optional) keys are used for’ those cases where UPDATE 
is being used as a building btock of a targer procedure, 
The NOS job control register EFG is set to zero (0) in the 
event of a successful completions. and to non zero if the 
UPDATE process bombs for any reason, If status is not 
specified and an error occcurss the orocedure EXITs. 


nomsg : 

these (optional) keys contro! the generation of informative 
messages by this procedure and ar2 fully described in the 
section entitied INFORMATIVE. MESSAGES FROM SES 
PROCEDURES*®,. 


(optional) Master Character to he used instead of the 
standard master character {(*). If you don*t code the amc 
parameters, UPDATE uses the vatue of orofile variable 
updtmcecs and if there's no such orofilte variables uses the 
default master character asterisk (*), 
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Examplie of UPDATE Usage 


seseupdate (mondaystuesdaysfriday)s pizxcobotpt 
* APPLYING MONDAY.eFRIDAY TO COBOLPL 

* NEW LIBRARY ON SESTMPL 

* NEW LIBRARY NOW ON COBOLPL 

* SESTMPL PURGED 

REVERT. END UPDATE COBOLPL 


This example shows a Jlist of modifications in files monday» 
thursday and friday applied against the cobolot orogram tibrary. 
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20.0 STRUCTURED. PROCESS TOOLS 


SCAD_=_ SOFTWARE COMPUTER. AIDED DESIGN 


The structured process tools are a set of Design Dictionary 
utilities, Computer Graphics Design tools and CYBIL to Structure 
Chart tools. They support the Structured Anatysds/Structured Design 
{SASD) methodology used for develonpment of software. 


SCADG creates or updates DFD» SCT and DS) diagrams used in the 
SASD methodology. 


SCADGEDIT a utility that enables a user tn edits copys reorders 
merge and list title infornation for diagrams in 
notebooks created by SCADG. SCADSEDIT does not reauired 
agraphics terminal. 


DDCREATE creates a design dictionary. 


DDDISPLAY disptays the contents of a design dictionary. 


DDOMERGE merges two design dictionaries ints a news third design 
dictionary. 


DOXREF prepares a cross reference listing of a design 
dictionary. 


DDXCHK checks a design dictionary for consistency. 


DDHREF produces hierarchical expansion reports for selected 
entries in a design dictionary. 


DDEDIT provides for interactive editing of entries in a design 
dictionary. 
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CyTosct 


cyToodD 


DOTOSCT 


FINTOSCT 


FINTODD 


creates graphics notebook files: of structure charts from 
CYBIL source code. 


is the first phase of CYTOSCT. CYTODD creates a design 
dictionary for input into DDTIStT {see note below on 
advanced design dictionary). 


creates graphics notebook files of structure charts from 
design dictionary files produced by CYTOOD {see note 
below on advanced design dictionary). 


creates graphics notebook files of structure charts from 
FORTRAN source code, 


is the first phase of FINTOSCT. FINTODD creates a design 
dictionary for input into O9T9SCT {see note below on 
advanced design dictionary). 
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The Computer Graphics Diagram tool supoorts the Data Flow Diagram 
{(DFD)» Structure Charts (SCT) and Oata Structur’e Diagram (DSD). 
These diagrams can be created» printeds saveds recalled and updated 
using a COC 721-3059 <IST=-III or TEKTRONIX! 4914 Graphics Terminal. 
The COC 721-30 requires the 721-301 Graphics/Firmware option. See 
the “Applicable Documents" section of this. document for the manual 
that supports the SCAD Graphics. 


The Design Dictionary Utilities provide a set of creations 
updatings checking and printing functions» The Design Dictionary 
consists of CREATE» DISPLAYs MERGE» XCHEC%»s XREFs HREF and EDIT 
functions. See the “Applicabte Documents” section of this document 
for the manual that supports the Design Dictionary. 


The CYBIL and FORTRAN to Structure Chart tools create graphics 
notebook files from CYBIL or FORTRAN Source code. The process 
consists of two proceduress CYTGDD or FINTO9D and DDOTOSCT. The 
procedures can be run separately or as a single orocedures CYTOSCT 
or FINTOSCT (see note below on advanced deasiaqn dictionary). See the 
NOS GRAPH Graphics User's Handbook in the "Aoplicable Documents" 
section of this document for the manual that suovorts the CYBIL and 
FORTRAN to Structure Chart toots. 


NOTE: The design dictionaries produced by the CYBIL and FORTRAN to 
Structure Chart tools are an advanced version of design 
dictionary. These advanced design dictionaries are not 
compatible with the current design dictionary toolss DDCREATEs 
DODISPLAY»s etc. 
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2001 SCADG_ = _CREATE_OR_ UPDATE _SASD_ DIAGRAMS 


The SCAD Graphics tools SCADGs» supoosrts the creation and 
maintenance of Data Fiow Diagrams (DFO), Data Structure Diagrams 
(DSD) and Structure Charts (SCT). These diagrans are the primary 
diagrams used in the SASD technique. It is: assumed vou are familiar 
with SCAD. Parameters to SCADG are? 


ntbk = 3: 
{optional) name of the initial fite to be used as the 
source notebook. If this pararneter tis not codeds SCADG 


uses the value of the profile vartabie ntbk. If the ntbk 
parameter is not defined in the user's profites SCADG uses 
the filename NOTEBK. The ntbk notebook is copied to a 
working files SESTMNB»s if the natbk and newntbk notebooks 
are the same file; otherwises the working notebook is the 
newntbk notebook. If the ntbk File does not exists SCADG 
creates a new notebook. 


newntbk: : 
(optional) name of the file to receive the updated ntbk 
notebook. If the newntbk paraneter is omitted or is the 
same as ntbks the new or updated notebook is copied back 
over the ntbk file. 


term : 
the term parameter specifies the usert*s terminal type. 
Valid terminal type entries are : 7215 IST3 or TEK4014. If 
this parameter is not codeds S2A9G uses the value of the 
profile variable term. If not defined in the user's 
proflles SCADG requests the terminal type. 


baud : 

represents the baud rate of your terninal. <Acceptabie 
values for each terminal type are as folfows: 721 -—- 300» 
1200, 2400» 4800 or 9600. IST3 - 300s 1200 or 2400. 
TEK4014 =—- 300s 1200» 24005 4800 or 9500. If this parameter 
is not codeds SCADG uses the value of the orofile variable 
baude If not defined in the userts: profiles SCADG requests 
the baud rate. 


hardcopy : 
indicates whether the terminal has a hardcopy device 
connected. This parameter may be given values of YES» 
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fy*, *®NO® or "N98. If this paraneter is not codeds the 
value of the profile variable hardcopy is used. If not 
defined in the user's profiles ‘StTA9G requests whether a 
hardcopy device is present. 


egm : 
refers to the Extended Graphics Module of the TEK4014. 
Acceptabie values for the egm paraneter are TYESt» TY%,% 
‘NO’ or *N?,. The egm parameter does not apply to IST3 or 
721 terminals. If this parameter Is not codeds SCADG uses 
the vatue of the profile variabi' egme If not defined in 
the user's profiles SCADG requests whether EGM is present. 


sync : 

refers to Synchronous or Asynchronous node for a TEK4014 
terminal. The syne parameter does not apoly to IST3 or 721 
terminals. Acceptable values for’ the sync parameter are 
"A' or 'S*. If this parameter is not codeds SCADG uses the 
value of the profile variable synee If not defined in the 
user's profiles SCADG requests «hether the terminal is 
running in A or S mode. 
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Example of SCADG Usage 


SESeSCADG NTBK=MYBOOK NEWNTBK2MYNEWBK: 
ENTER TERMINAL TYPE (IST3»s 721 OR TEKSO14) 


? 721 

WHAT BAUD RATE (3009 1200» 2400» 4800 OR 9600) 

2? 9600 

WITH HARDCOPY,» (YES OR NO) 

? Y 

* * 
* * 
* PREPARING SCADG — PLEASE WAIT * 
*. * 
BEGINNING SCADG 2.1 UPDATING MYBI9K' => MYNEWBK 

OLD NOTEBOOK = MYBOOK NEW NOTEBOOK = MYNEWBK 


TYPE IN COMMAND 
? 


{( SCADG interactive session ) 


REVERT. END SCADGs NOTEBOOK PROCESSING COMPLETE. 
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2002 SCADGEDIT =_ DIAGRAM _ HEADER EDIT § LIST: NOLTERQOK_UTILs 


The SCADGEDIT SES procedure provides a utility for editing and 
fisting the diagram titie blocks and notebook maintenance. 
Parameters to SCADGEDIT are? 


ntbk : 

{optional) name of the file containing the notebook. If 
this parameter is not codeds SCADGEDXIT uses the filename 
NOTEBK. The ntbk notebook is consied to a working file 
SESTMNB if the ntbk and newntbk notebooks are the same 
files otherwise the working notebook fs the  newntbk. 
notebook. No changes are made to the ntbk notebook unless 
it is also the new notebook and than only after SCADGEDIT 
terminates» 


newntbk 3 

(optionat) name of the file to be used as the new notebook. 
If this parameter is not codeds disposition depends on the 
profile variable oldeqnew. If there is no such variable 
defined in the profile or oldeqnew has a vaiue of FALSE» 
SCADGEDIT writes the notebok ts the File NEWNTSK. If 
oldeqnew has a value of TRUE» SCADSENIT writes the notebook 
back to the ntbk notebook. 


{optiona!) name of the file to receive the listing output 
from SCADGEDIT. If this parameter itis not codeds then 
SCADGEDIT will use the filename LISTING for tisting output. 


dfite : 
(optional) name of the file containing directivess in NOS 
64 character set formats for the SCADGEDIT processor. If 
this parameter is not codeds then SCADGEDIT accepts 
directives from the terminal ors in the case of a batch 
jobs from the filename INPUT. The dfite file is jy:ewound 
before it is used. 


print : | 
(optional) parameter to control the PRINTing of the outputs 
{ file. When the job runs in batch mote and there is no | 
files one copy is printed autonaticalttvy. If running the 
procedure in tocal modes no copies: are printed untess the 
user specificaliy codes some print oarameter. For examples 
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you code print=c=3 to obtain three copies of the f file. 
The format of the print parameter’ is: that of the parameters 
for the PRINT procedure. 
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20.3 DOCREATE =-_CREATE_A_DESIGN DICTIONARY 


The DDCREATE function takes a user text inout fille and creates a 
Design Dictionary {DD) file. Parameters to ODCREATE are 3: 


(optional) name of the file containing the source for 
creating the DD. If you don't code the i: parameters then 
DDCREATE uses the vatue of the profite variable ddis and if 
there's no such variable defined in your profiles then 
DOCREATE uses the filename DDTEXT. The t file is rewound 
before it is read. 


new : 
(optional) name of the file onto which the new DD is to be 
written. If you dontt code the new parameters, then 
DOCREATE uses the value of the profite variabie ddnews and 
if there's no such variable defined in your profiles then 
DOCREATE uses the file name NEWDD.= 


Example of DDOCREATE Usage 


SES -DDCREATE I=MYTEXT»s NEW=MYNEWDD 
* BEGINNING DD CREATE 
{ Additional informative nessages from DOCREATE }) 
+ MYTEXT ---=-> MYNEWDD 
REVERT. END DD CREATE 


This example shows DDCREATE used to create a new design dictionarys 
MYNEWDDs from the text in the source file WYTEXT. 
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2024 DODISPLAY = DISPLAY A_DESIGN. DICTIONARY’ 


The DDDISPLAY function extracts entries fron a design dictionary 
and writes them to an output text file.’ Extraction criteria are 
specified by directives on a directives file or by specifying a 
dlist parameter. Parameters to DDDISPLAY are 3° 


old :; 
{optional) name of an old design dictionary file From which 
entries are to be extracted. If vou don't code this 
parameter, then DDDISPLAY uses the value of the profile 
variable ddotds and if there's no such variable defined in 
your profiles then DDDISPLAY uses the filename OLDDD. 


(optional) name of the file to receive the output from 
DDDISPLAY. If you don't code this parameters then 
DDDISPLAY uses the value of the orofite wariable ddos and 
if there's no such variable defined in your profiles then 
DDDISPLAY uses the filename ODOOTEXT.? The o file is not 
rewound. 


dfille ;: 

(optional) name of the File containing directives» in NOS 
ASCII tine-image formats to the DDOISPLAY processor. If 
you dontt code this parameters DODISPLAY uses the vatue of 
the profile variable dddfile. If there's no such profile 
variable defined in your profile and a dtist parameter is 
not specifieds then DDDISPLAY accepts directives from your 
terminal ors in the case of a batch job» from the filename 
input. The dfite is not rewound. If you code the dfile 
parameters don*t code a dflist paraneter. 


dtist : 

(optional) parameter specifies a ODDISPLAY directive or 
directive list. <Acceptabie values for dt¥st include: ails 
allhs datas files flows components elements process»: 
Processhs modules dfds dfdh»s sects notypes and undef. 
Directives of the form *psn n* may afso be included in the 
diist. Coding the dftist parameter fis equivaitent to 
specifying directives on a dfilte (directives) file. If you 
code the dtlist parameters, don't code the dftte parameter. 
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(optional) name of a Base Library to be updated.» If you do 
not code the bor the m parameters dissiay output is not 
placed in a Base Library. If you. code the m parameters but 
not the b parameter, the b parameter defaults to BASE. 


ms 
(optional) name of the Common Module to be created from the 
display outpute REPMOD reptaces the m module on the b Base 
Library. If you code the b paraneter’ and not the m 
parameter, the m parameter defaults: fo DICT. 

print : 


(optional) parameter to contro! the PRINTing of the outputs 
o file. When the job runs in batch node and there is no o 
files one copy is printed automaticalty. If you run the 
procedure in tocal modes no conies are orinted untess you 
specifically code some print paraneter.e. For examples you 
code printsc23 to obtain three conies of the parameter o 
file. The format of the print paraneter is that of the 
parameters for the PRINT procedure. 


Exampie of DDDISPLAY' Usage 


SES eDDDISPLAYs OLD=MYOLDDDs O=LISTITs DFILE=DOWHAT 
* BEGINNING DD DISPLAY 
ACCEPTING DISPLAY DIRECTIVES 


( Additional informative messages: friom DDDISPLAY ) 


* MYOLDDD <---> LISTIT 
REVERT. END DD DISPLAY 


This example shows DDDISPLAY used to disoslay selected entries from 
the design dictionarys MYOLDOD. The directives for selecting 
entries were read from the file DOWHAT. I[f the dfite parameter had 
been omitteds directives would have been read from the file INPUT. 
The tisting of formatted design dictionary entries was written to 
the file LISTIT in the order selected by the directives read from 
the file DOWHAT. 


The b and om parameters are useful for inctuding sections of the 
design dictionary as sections of an Analysis and Design 
Seecifications document. 


20-12 
CoC. — SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Han deck REV: 4A 
20. O STRUCTURED PROCESS TOOLS 
20.2.5 DDMERGE - MERGE TWO DESIGN DICTIONARIES 


AR AS ND NS SD NED ND AED NS AE A ON OD ee NE Ae ASN DD ED ADD D-DD ND Ee ON ED AD ER SED ND ES A ED SD ND ED A A OD A OD NS ED EE ED AD ED ED ED AD OE ED ED OD A -D- e  e 


20-5 DOMERGE = MERGE TWO. DESTON DICTIONARIES. 


The DDMERGE function combines two design dictionaries to produce 
aonews third DD. Parameters to DDMERGE are 3: 


old : 
(optional) name of the old design dictionary file with 
which you wish to merge another design dictionary. If you 
don't code the old parameters, then DOMERGE uses the value 
of the profile variable ddolds and if there*s no such 
vatiable defined in your profites then DDMERGE uses the 
filename OLDDD. 

new ; 
{optional) name of the file onto which the new DD is to be 
written. If you dontt code the new parameters then DDMERGE 
uses the value of the profile variabte ddnews and if 
there's no such variable defined In your profiles then 
DOMERGE uses the file name NEWDD. 

merge ; 
(optional) name of the design dictionary File you wish to 
merge with the of!d design dictionary. If you don#t code 
the merge parameters, DDMERGE uses tha vatue of the profile 
variable ddmerges and if there’s no such variabte defined 
in your profiles then DDMERGE uses the filename MERDD. 

replace : 


(optional) key causes entries contained In the otfd design 
dictionary whose names are duplicated hy entries contained 
in the merge design dictionary to be REPLACE'd by the merge 
design dictionary entries. <A fFil® named ODLOG will contain 
a list of duplicate entries and the action taken in each 
Cas@e 


Exampie of DDMERGE Usage 
SES-DDMERGEs OLD=MYOLDDDs MERGE=4ERGEDDs NEWeMYNEWDDs REPLACE 
*. BEGINNING DD MERGE 


* MYOLDD + MERGEDD ----> MYNEWDD 
REVERT. END DD MERGE 


This exampie shows the use of DDMERGE to conbine entries from the 
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design dictionaries MYOLDDD and MERGEDD to form a new design 
dictionary MYNEWDD. If an entry name is defined tn both MYOLDDD and 
MERGEDD then the definition used in creating MYNEWOD is taken from 
MERGEDD. If the REPLACE parameter had been omitteds the definition 
from MYOLDDD would have been used.s In either’ case an explanatory 
record is written to filename DDLOG. 
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20-6 DOXREF_~_CROSS_ REFERENCE _A_ DESIGN DICTIONARY 


The DDXREF function produces a formatted cross reference tisting 
of part or all of a design dictionary. Paraneters to DDXREF are :. 


old : 
{optionai) name of the ofd dasign dictionary file from 
which you want across reference listing.’ If you dont 
code the ofd earametery then DDOXREF uses the value of the 
profile variabte ddotds and if there's no such variable 
defined in your profiles then OOXREF uses the Filename 
OLDDD. 


(optional) name of the file to receive the output of DDXREF 
in a form suitable for printing on the ASCII printer. If 
you don't code the ! parameters then DOXREF uses the vatue 
of the profite variabie ddf. If ther'e®s no such variable 
defined in your profiles and you're running DDXREF LOCAL at 
your terminals the output appears on a File called LISTING. 
The i file is not rewound. 


ret : 
(optional) parameter selects the type of entries you want 
to be included in the cross reference listing. <Acceptable 
values for ref are: Flows components elements files datas 
processs modules dfds scts notypes undefs and alt. 


width ; 

(optional) parameter selects the page width of the output 
listing written to the 8 File. Accentahbte values for width 
are printer or term (for terminal width). If you dontt 
code the width parameter, then DDXREF uses: the value of the 
profile variable ddwidths and if therets no such variable 
defined in your profites your listing will be formatted for 
a line printer. 


print 3: 
(optional) parameter to controf the PRINTing of the outputs 
' file. When the job runs in batch mode and there is no 1 
files one copy is printed automatically. If you run the 
procedure in tocal modes no copies are printed unless you 
specifically code some print paranetere For examples you 
code printzecs*3 to obtain three copies of the parameter i! 
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file. The format of the print paraneter ts that of the 
parameters for the PRINT procedure.) 


Exampie of DDXREF Usage 


SES eDDXREFs GQLDO=MYOLDDDs LeLISTITs REFZALL» WIDTH#TERM 
* BEGINNING DOD XREF 
(Additional informative messages fron DDOXREF) 
* MYOLDDD ----> LISTIT 
REVERT. END DD XREF 


This exampfie shows the use of DDXREF to obtain a terminal width 
cross reference listing of all sections of the design dictionary 
MYOLDDD. The cross reference listing will be on the focal file 
LISTIT.»} Printed copies could have been obtained by adding a PRINT 
parameter. For examples PRINT#(C=3sH=*XLIST®) would have caused 3 
copies with a header XLIST to be printed. 
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20-7 DDACHK = CHECK A DESIGN DICTIONARY £OR_ CONSISTENCY 


The ODXCHK function runs a cross check against a design 
dictionary. A formatted listing is oroduced wahich contains the 
names of entries which meet criteria selected by the check 
parameter. Parameters to DDXCHK are 3: 


old : 
(optional) name of the design dictionary File you want 
cross checked. If you don't code the ofd parameters then 
DDXCHK uses the value of the profite variable ddoflds and if 
there's no such variable defined In your’ profiles then 
DDXCHK uses the Filename OLDDOD. 

{3 
(optional) name of the file to receive the output of DDOXCHK 
in a form suitable for printing on the ASTIY printer. If 
you don'tt code the 1! parameters, then DJOXCHK uses the vaiue 
of the profile variable ddl. If there's no such variabie 
defined in your profiles and you're running DDXCHK iocal at 
your terminals the output appears on 4a file calted LISTING. 
The 1 file is not rewound. 

check 2? 
(optional) parameter specifies the kind of consistency 
check you want run against the ofd design dictionary. 
Acceptable values for check are: undefs unrefs norefs» 
recurs and full. 

print : 


(optional) parameter to controt the PRINTIng of the outputs 
§ file. When the job runs in batch node and there is no 1 
Files one copy is printed automatically. If you run the 
DDXCHK procedure in tocal modes 19 coples are orinted 
untess you specifically code som2 print parameter. For 
examples you code printzc#2 to obtain two copies of the 
parameter ! File. The format of the print parameter iis 
that of the parameters for the PRINT procedure, 
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Exampte of DDXCHK Usage 


SESeDDXCHKs OLD=MYOLDDDs LeLISTITs CHECK*eFULL 
*. BEGINNING OD XCHECK: 
{ Additional informative messages: from DDXCHK ) 
* MYOLDDD <---> LISTIT 
REVERT. END DD XCHECK 


This example shows the use of DDXCHK to perform a full cross check 
of the design dictionary MYOLDDD. The cross check listing will be 
on the tocal file LISTIT. Printed copies could have been obtained 
by adding a PRINT parameter. 
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2068 DOUREF _~-_HIERARCHICAL REF _EXPANSIONS _F28_A_DESTGN DICT 


The DDHREF procedure produces Hierarchical REEerence expansion 
reports for selected entries in a design dictionary. 


old : 
{optional) name of the design dictionary file from which 
you want hierarchical reference expansions. If you dont 
code the otfd parameters then DDHREF uses the value of the 
profile variabie ddotds and if therets: no such variable 
defined in your profiles then DDHREF assumes the design 
dictionary is on a file called OL909. 


1 3 
(optional) name of the file to receive the output of DDHREF 
in a form suitabie for printing on the ASCII printer. If 
you don't code the ! parameters, then ADHREF uses the value 
of the profile variable ddi. If thera fs no such variable 
defined in your profiles then DDHREF outout appears on a 
file calted LISTING. The 1? file Is not: rewound. 

dfile : 


{optional) name of file containina directives to DDHREF in 
NOS ASCII tine-image format. 


enter/noenter : 
{optional) key controlling selection of interactive 
directive input to DDHREF. Enter selects interactive 
directive input via your terminal keyboard. The default is 
noenter (i.2@.» no terminal interaction). If a dfile was 
specifieds interaction would occur after DOHREF reads the 


dfile. 

fevelis : 
Coptional) maximum number of hierarchical tevets to which 
DDHREF will expand design dictionary entries. If 


specifieds the value must be an Integer from 1 to 105 the 
default vatue is 5. 


droots/nodroots 3 
{optional) key controlling selection of the DDHREF derived 
roots entry name expansions. Specifying droots causes 
these entry names to be expanded at the end of your ODHREF 
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print 


session. Specifying nodroots causes DOHREF to only expand 
the user supplied entries in the supplied root fist. The 
default value is nodroots if the enter key is specifieds 
otherwise the default vaiue is droots.: 


* 
» 


(optional) parameter to contro!’ the printing of the 1 
(output) file. When this job runs: in batch mode and there 
is no 4 files one copy is printed automatically. If you 
run the DDHREF procedure in tocal mode», no copies are 
printed unftess you specifically code some print parameter. 
For examples you code print=c=2 to ohtain two copies of the 
parameter 1 file. The format of the print parameter is 
that of the parameters for the PRINT orocedure,. 
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2009 DDEDIT - EDIT A DESIGN DICTIONARY 


DDEDIT allows you to interactively examine and alter the contents 
of a design dictionary on an entry-by-eantry basis via directives 
that you enter from your terminal. Parameters to DDEDIT are : 


old 


oe 


(optional) name of an existing desiaqn dictionary that you 
want to edit. If you don't code this oarameter and also 
don't specify the create key (described below)» then DDEDIT 
uses the vatue of the oprofite variabte ddotds and if 
there's no such variable defined in your orofiles then the 
filename OLDDD is used. 


oe 


new 
(optional) name of the file onto which the new edited 0D Is 
to be written. If you dontt code the new parameters then 
DDEDIT uses the value of the profile variable ddnews and if 
there's no such variable defined in your porofiies then the 
filename NEWDOD is used. 


scr : 
(optional) name of the file that contains or wilt contain 
entries you wish to add or reoslace in your design 
dictionary. If you don*t code the ser parameters then 
DDEDIT uses the value of the profile variable ddscrs and if 
there's no such variable defined in your profiles then the 
filename SCRATCH is used. 


(optional) name of the text editor you want to use to edit 
entries on the scr file. Acceotah{te vatues for e are 
XEDITs EDITs EDT or FSEe If you dontt code this parameter» 
DDEDIT uses the vatue of the profile variable ddes and if 
there's no such variable defined in your profiles, youtif 
get XEDIT as your editor. 


create : 
(optional) key when specified indicates to ODEDIT that you 
want to begin a new DD. If you ecsde the create keys you 
can't code the old parameter. 
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Example of ODEDIT Usage 


SES~DDEDITs OLD=MYOLDDDs NEW2MYNEWDDs SCR2MYSCRs EsFSE 
* BEGINNING DD EDIT 
ENTER DDEDIT DIRECTIVE. 


(Additional DDEDIT/User Interaction) 
REVERT. END DD EDIT 


This example shows DDEDIT being used to edit an existing design 
dictionarys MYOLDDD. During the ODEDIT sessions text editor FSE is 
used to edit 00 entries contained on the file MYSCR. When the 
DDEDIT session is terminateds the edited 99 is to be written to file 
MYNEWDD. 
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20010 CYTOXCT = CYBIL_TO_ STRUCTURE CHARTS 


The CYBIL to Structure Chart tools, CYTOSCTs» creates an SCAD 
graphics notebook from CYBIL source code. CYTOSCT performs the 
combined functions of the CYTGDO and O9TISCT tools. Input to 
CYTOSCT is syntax error free CYBIL source code. The CYTOSCT tool 
creates: 


1) a graphics notebook. 

2) a table of contents listing and an index IJlisting of the 
graphics notebook. 

3) a cross reference tlisting of the desiaqn dictionary (tif 
selected), 


(See note on advanced design dictionary at the beginning of 
this section.) 


Parameters to CYTGSCT are : 


input or i: 
{optional) name of the file containing error free CYBIL 
source code. If you don't code the 4 parameters CYTOSCT 
uses the value of the profile variable cdi.z If there is no 
such variable defined in your profiles CYTOSCT assumes the 
CYBIL source is contained on a file naned COMPILE. 


ntbk : 
(optional) name of the file onto which the new notebook is 
to be written. If you don’t code the ntbk parameters 
CYTOSCT uses the vatue of the ordfile variable ntbke If 
there is no such variable defined in your profiles CYTOSCT 
uses the filename NOTEBK. 


nitist : 
(optional) name of the file onto which the table of 
contents and index tistings for the notebook are to be 
written. If you don't code the ntist oarameter, CYTOSCT 
uses the value of the profile variable ntist.e. If there is 
no such variable defined in your profite, CYTOSCT uses the 
filename NLIST. 


order : 
(optional) parameter to control the order of the structure 
charts that are generated. If the order sarameter is coded 
as As the structure charts are oprodused in alphabetical 


20-23 


COC - SGFTWARE ENGINEERING SERVICES 


18 December 84 


SES User's Handbook REV: 4A 
20.0 STRUCTURED PROCESS TOOLS 
20.10 CYTOSCT = CYBIL TO STRUCTURE CHARTS 


newdd 


xref 


print 


un 


ee 


order. If the order parameter is coded as: Hs the structure 
charts are produced in hierarchical: order. The default 
value for the order parameter is Ae 


3 


{optional) name of the file onto which the new design 
dictionary is to be written. If vou donr*'t code the newdd 
parameters, CYTOSCT uses the vaiua of the profile variable 
ddnewe If there is no such vartable defined in your 
profiles CYTOSCT uses the filenanea DDONEW. 


{optional) name of the file onto which a cross reference 
listing of the new design dictionary Is to be written. If 
you dontt code the xref parameters CYTIUSCT uses the value 
of the oprofite variabie ddxref.: If there is no such 
variable defined in your profites, no cross reference 
listing is generated. 


e 
a 


(optional) parameter to control oritnting of the niist and 
xref files. If you code the print keywords one copy of 
each of the files is printed. You code printzc22 to obtain 
two copies of each file. The fornat of the print parameter 
is that of parameters for the SES.PRINT procedure. 


(optional) user name associated with fites used by CYTOSCT. 
If you don't code the un parameter’ CYTOSST uses the vaiue 
of the profile variable cyune If there is no such vartable 
defined in your profiles CYTOSCT assumes the files are in 
the current userts catalog. Note: If wn is not the current 
user*s catalogs the ntbk and newdd Files mnust exist with 
write permission. In focal mode CYTOSCT allows the use of 
local files for nilist and xref filles» but in batch mode 
these files must exist with write oermission. 
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Example of CYTOSCT Usage 


SES-CYTOSCT [=COMPILE NEWDD*DDFILE: NTBK@NBFILE oe 
NLIST=NTBKLST 

*. BEGINNING CYTOSCT V 1 ON COMPILE => DDFILEs NBFILE 
*. BEGINNING CYTODD V 1 ON COMPILE => ODDFILE 


2 id ® 


END CYTODD COMPILE ----> DDFILE 
BEGINNING DDTOSCT V 1 ON ODFILE -> NBFILE 


+ % 


2 2 2 


CREATING UNFORMATTED NOTEBO3< 

CONSOLIDATING NOTEBOOK 

FORMATTING NOTEBOOK 

END CYTOSCT COMPILE <-> NBFILEs NTBKLST 
EVERT. 


at te HH 


This exampie shows CYTOSCT creating a yew DD File, DDFILEs and a 
new graphics notebooks NBFILEs from the CY3IL source code found on 
file COMPILE. The table of contents and index listings of the 
notebook are on the permanent file NITBKLST.! 
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20011 CYTQ00 = CYBIL_TO_ DESIGN DICTIONARY 


The CYBIL to Design Dictionary tools CYT390» fis the First phase 
of the CYBIL to Structure Chart tool» CYTISCT. The CYTODD tool 
creates a design dictionary that is input to the DOTOSCT tool {see 
note on advanced design dictionary at the beginning of this 
section). Parameters to CYTODD are 3 


input or i : 
(optional) name of the compile file containing error free 
CYBIL source code. If you don't code the i parameters 
‘CYTODD uses the value of the ornfile variable cdi. If 
there is no such variable defined in your profiftes, CYTODD 
uses the filename COMPILE. 


newdd : 
{optional) name of the file onto which the new DD is to be 
writtens If you don't code the newdd osrameters CYTODD 
uses the value of the profite vartabte ddnew. If there is 
no such variable defined in your orofiles CYTODD uses the 
filename DDNEW. 


xref : 
(optional) name of the file onto which a cross reference 
listing of the new design dictionary ts to be written. If 
you don't code the xref parameter, CYTIDD uses the value of 
the profile variabie ddxref. If there is no such variable 
defined in your profiles no cross reference tlisting is 
generated. 


print : 
(optional) parameter to control ortnting of the xref file. 
If you code the print keywords one conoy of the file is 
printed. You code printzc#2 to obtain two copies of the 
xref File. The format of the print voar'ameter is that of 
the parameters for the SES.»PRINT vprocedure. 


un 
{optional) user name associated with files used by CYTQDD.. 
If you don't code the un parameters CYTOD) uses the value 
of the profile variable cyune If there Is no such variable 
defined in your profiles, CYTODD assumes files are in the 
current user's catalog. Note: [f un is not the current 
user's catalogs the newdd file nust exist with write 


20-26 
COC — SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook. REV: 4A 
20.0 STRUCTURED PROCESS TOALS 
20.211 CYTQDD ~- CYBIL TO DESIGN DICTIONARY 


permission. In focal mode CYTOD) allows the use of a local 
file for xrefs but in batch mode xref nust exist with write 
permission. 


Exampie of CYTODD Usage 


SES-CYTODD I[=COMPILE NEWDD=DDFILE 

* BEGINNING CYTODD V 1 GN COMPILE => DDFILE 
* CYBIL COMPILING COMPILE 

* BEGINNING CREATION OF DDFILE 

* PROCESSING TEXT FOR MODULE 49301 

*. PROCESSING TEXT FOR MODULE 4902 

* END CYTODD COMPILE ----> DDFILE 

REVERT. 


This example shows CYTOOD compiling source code found on file 
COMPILE and creating a design dictionary on File DDFILE. 
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20.12 DOTOSCT -_ DESIGN DICTIONARY TO SIRUCTIRE CHATS 


The Design Dictionary to Structure Chart’ tools ODDTOSCT» is the 
second and last phase of the Source Code to Structure Chart toolsys 
CYTOSCT and FINTOSCT. The DBDTOSCT tool creates an SCAD graphics 
notebook from a design dictionary created by CYTNDD (see note on 
advanced design dictionary at the beginning of this section). 
Parameters to DOTOSCT are 3: 


oltddd : 
{optional name of the file containing the design 
dictionary created by CYTODD. IF you dontt code the otddd 
parameter, ODDTOSCT uses the value of the profile variable 
ddold. If there is no such variabte defined in your 
profifies DDTOSCT uses the filename ILDOD, 


ntbk : 
(optional) name of the file onto which the new notebook is 
to be written. If you dontt code the ntbk parameters 
DDOTOSCT uses the vatue of the profifte variable ntbk. If 
there is no such variabte defined in your profiles DDTOSCT 
uses the filename NOTEBK. 


niist : 
(optional) name of the file onto which the table of 
contents and the index information For’ the notebook is to 
be written. If you don#t code the nt¥st oarameters, DOTOSCT 
uses the vaiue of the profile variable ntist. If there is 
no such variable defined in your profiles DDTOSCT uses the 
filename NLIST. 


order : 
(optional) parameter to control the order of the structure 
charts that are generated. If the order parameter is coded 
as A» the structure charts are oroduced in aiphabetical 
order. If the order parameter is coded as Hs» the structure 
charts are produced in hierarchical order. The default 
value for the order parameter is Ae 


print : 
(optional) parameter to contro! the printing of the niist 
file. If you code the print keywords one copy of the file 
is printed. You code printzcz2 to obtain two copies of the 
niist file. The format of the print paraneter is that of 
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un 3 


parameters for the SES.PRINT proca2dure,: 


(optional) user name associated with files used by DDTOSCT. 
If you don't code the un parameters DDOTOSCT uses the vatue 
of the profile variable ddune If there is no such vartable 
defined in your profiles DDOTISCT assumes that the olfddd 
parameter file is in the current userts catalog. Note: If 
un is not the current user's catalogs the ntbk file must 
exist with write permission. In focal mode DDTOSCT allows 
use of a ltocal file for niists but in batch mode ntist must 
exist with write permission. 


Example of DDOTOSCT Usage 


SES-DDTOSCT OLDDD=DDFILE NTBK=NBFILE 

* BEGINNING DDTOSCT V 1 GN DDFILE => NBFILE 
* CREATING UNFORMATTED NOTEBODK: 

* CONSOLIDATING NOTEBOOK 

* FORMATTING NOTEBOOK: 

* END DDTOSCT ODFILE => NBFILE»NLIST 
REVERT. 


This example shows DDTOSCT creating a new gravhics notebooks 


NBFILE>» 


from the file DDFILE. The notebook's tabfte of contents and 


index tistings are written to file NLIST. 
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20013 EINTOSCT =_ FORTRAN TO STRUCTURE CHARTS 


The FORTRAN to Structure Chart tools FINTISCTs creates an SCAD 
graphics notebook from FORTRAN 5 source code.» FITNTOASCT performs the 
combined functions of the FTNTOOD and ONTISCT tootse Input to 
FINOSCT is syntax error free FORTRAN 5 source coda. Other versions 
of FORTRAN: source code or FORTRAN 5 source code containing errors 
may be input to FINTOSCTs but some code nav not be recognized and 
will be bypassed. The CYTOSCT tool creates: 


1) a graphics notebook. 

2) a table of contents listing and an index listing of the 
graphics notebook. 

3) a tist file of the source code with line numbers. Any 
source code diagnostics will appear’ at the end of the tist 
file. 

4) a cross reference listing of the design dictionary (if 
selected). 


(See note on advanced design dictionary at the beginning of 
this section.) 


Parameters to FINTOSCT are : 


input or i 3: 

. (optional) name of the file containing FORTRAN source code. 
If you don't code the § parameter» FINTOSST uses the vatue 
of the profile variable ftndt.! If there is no such 
variable defined in your profiles FINTISCT assumes” the 
FORTRAN source is contained on a file named COMPILE. 


ntbk ; 
(optional) name of the file onto which the new notebook is 
to be written. If you don't code the ntbk parameters 
FINTOSCT uses the vatue of the profile variable ntbk. If 
there is no such variable defined in your profiles FINTOSCT 
uses the filename NOTEBK. 


nfist : 
Coptional) name of the file onto which the tabie of 
contents and index listings for the notebook are to be 
written. If you don't code the ntist parameters FINTOSCT 
uses the value of the profile variable ntist.e. If there is 
no such variable defined in your orofif'e, FINTOSCT uses the 
filename NLIST. 
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order : : 
{optional) parameter to contro! the order of the structure 
charts that are generated. If the order parameter is coded 
as As the structure charts are oroduced in alphabetical 
order. If the order parameter is coded as Hs the structure 
charts are produced in hierarchical order, The default 
vatue for the order parameter is A. 


mode or m : 
(optional) paramter to indicate the mode of the source 
input. If the mode parameter is ronseqs all the source is 
considered to be written in nonsequeanced mode. The mode 
parameter can also be seq which indicates that the source 
line is preceded by a sequence nunber. The default value 
for the mode parameter is nonseq. 


newdd : 
(optional) name of the file onto which the new design 
dictionary is to be written. If you don*t code the newdd 
parameters FINTOSCT uses the vatue of the profile variabte 
ddnewe If there is no such variable defined in your 
profiles FITNTOSCT uses the filenane DONEW.’ 


list or f 3 
(optional) name of a file onto which the source and any 
error messages will be listed. I? you don*t code the tist 
parameters, FITNTOSCT uses the filename LISTING. 


xref : 
(optional) name of the file onto which a cross reference 
listing of the new design dictionary Is to be written. If 
you don't code the xref parameters FINTOSCT uses the value 
of the profile variable ddxref.' Tf there itis no such 
variable defined in your oprofites no cross reference 
fisting is generated. 


print ;. 
(optional) parameter to control’ printing of the nlists 
fists and xref files. If you code the print keywords one 
copy of each of the files is printed. You code print=c#2 
to obtain two copies of each fils.’ The format of the print 
parameter is that of the paraneters for the SESsPRINT 
procedure. 
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un 3 
(optional) user name associated with files used by 
FINTOSCT. If you don't code the un parameters FINTOSCT 
uses the value of the profile variable ftnune If there is 
no such variable defined in your’ orofiles FINTOSCT assumes 
the files are in the current user'™s catalog. Note: If un 
is not the current user's catalogs the newdd and ntbk files 
must exist with write permission. In tocal’ mode FINTOSCT 
allows the use of focal files» for tists ntist and xref 
files but in batch mode these files must exist with write 
permissions 


Exampte of FINTOSCT Usage 


SESeFINTOSCT LT=COMPILE NEWDD=DDFILE NTBK@NBFILE os 
NLIST#2NTBKLST 

* BEGINNING FINTOSCT V 1 ON COMPTLE -> DODFILEs NBFILE 
* BEGINNING FINTGDD V 1 ON COMPILE => ODFELE 


* END FINTODD COMPILE <---> DDFILEs LISTING 
* BEGINNING FINTOSCT V 1 ON DDFILE -> NBFILE 
* CREATING UNFORMATTED NOTEBOOK 

* CONSGLIDATING NOTEBOOK 

* FORMATTING NOTEBOOK 

* END FINTOSCT COMPILE -> NBFILEs NTBKLST 
REVERT. 


This example shows FINTOSCT creating a Yew DD Fites DDFILEs and a 
new graphics notebooks NBFILEs from the FIRTRAN source code found on 
COMPILE file, The table of contents and index tistings of the 
notebook are on the permanent file NIYBKLST. A isting of the 
FORTRAN source and any error messages are on the file LISTING. 
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20-14 FINTOQDO =_FORTRAN_TO_DESIGN DICTIONARY 


The FORTRAN to Design Dictionary tools FINTONDs js the first 
phase of the FORTRAN to Structure Chart tools, FINTOSCT. The FINTODD 
tool creates a design dictionary that is inout to the DDTOSCT tool 
{see note on advanced design dictionary at the beginning of this 
section). Parameters to FINTODD are : 


input or §f 2? 
(optional) name of the compite file cantaining FORTRAN 
source code, If you don*t coda the f parameter, FINTOOD 
uses the vaiue of the profile variable ftndi.j If there is 
no such variable defined in your profiles FINTODD uses the 
filename COMPILE. 


newndd ; 
{optional) name of the file onto which the new DD is to be 
written. If you don't code the newdd ovarameters FINTODD 
uses the value of the profile variable ddnew.e. If there is 
no such variable defined in your’ orofittes’ FTINTODO uses the 
Filename DDONEW. 


mode or m 3: 
(optional) parameter to indicate the mode of the source 
input. If the mode parameter is nonseqs all the source is 
considered to be written in nonseaquenced mode. The mode 
parameter can also be seq which indicates: that the source 
fine is preceded by a sequence nunber.e. The default vatue 
for the mode parameter is nonseq. 


fist or 1 3: 
(optional) name of ae fite onto which the source and any 
error messages will be listed. If you. don't code the tist 
parameters FINTODD uses the filenane LISTING. 


xref 3 
(optional) name of the file onto which a cross reference 
listing of the new design dictionary is to he written. If 
you don't code the xref parameters FINTIND uses the vatue 
of the profile variable ddxref.: If there is no such 
variabte defined in your oproftite and vou don*t code the 
xref parametery no cross reference tisting is generated. 
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print 


un 3s 


2 
2 


{optiona!l) parameter to contro! printing of the tist and 
xref parameter files. If you code the print keywords one 
copy of the file is printed. You code printzc2#2 to obtain 
two copies of each file. The fornat of the print parameter 
is that of the parameters for the SESPRINT procedure. 


(optional) user name associated with files used by FITNTODD. 
If you don't code the un parameters FINTIOD uses the vaiue 
of the profile variable ftnun.' If there is no such 
variable defined in your profiles FINTIND assumes files are 
in the current user's catalog. Note: IF un is not the 
current user's catalog the newdd file must exist with write 
permission. In tocal mode FINTGD) allows the use of tocal 
files for tist and xrefs but in batch mod2 these files must 
exist with write permission. 


Exampte of FINTODD Usage 


SESeFINTODD L=COMPILE NEWDD=DDFILE 

* BEGINNING FTINTOOD V 1 ON COMPILE => DODFILE 
* GENERATING DD TEXT FROM COMPILE 

* CREATING DD DDFILE FROM DD TEXT 

* END FINTODD COMPILE ----> DDFILEs LISTING 
REVERT. 


This example shows FINTODD using source coda found on COMPILE to 
create a design dictionary on file DDFILE. A isting of the FORTRAN 
source and any error messages are on the fille LISTING. 
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A1.0 PROFILES 


A PROFILE is an importants albeit optionals component of SES 
us agee Any user may choose to establish a PROFILE In their catalog 
or procedure library. PROFILE follows the same rutdes as any SES 
procedures that is» the name of the file nust be PROFILE» and the 
first tine ot the profile must be the word PROFILE. From there ons 
the profite may contain just about any SES sommand. The most 
important aspect of the profile is the SEARCH directives explained 
in the next section. 


Typicaliys the types of things that a4 user may place in the 
profile would be : 


o acommand to set a variable called PASSWOR to the user's 
password. Procedures which optionally run as batch jobs can 
then get the user'*s password without having to be toid it an 
the SES control statement. 


o commands to establish defaults for tibrary names (for the 
source code and library maintenance orocedures)s tape numbers 
{and reiated information for the tape nanagement procedure), 
and other data for various procedurese 


o SEARCH directives to establish a search order for procedures. 

It is possibte for a user to have nore than one PROFILEs and 
select which one to use by coding the PN or ° noaraneter on the SES 
control statement. For examples by coding : 

sesspnzaiternate_profile.procedure_nane tistiof_ parameters 

a user canuse the file “alternate_profile™ as the PROFILE for the 
duration of that procedure call. Also» a user may use <‘omeone 
else's profile by coding the PUN or PU parameter. For examples by 
coding :. 


sesspunzprofile_owner.procedure_name tist of_parameters 


@ouser can access the profile belonging to "profiile_owner”™. Of 
courses the PN and PUN parameters may be used together. 
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Ale0.1 SEARCH DIRECTIVE -— ESTABLISH LIBRARY SEARCH ORDER 


Using the SEARCH directives a user can establishs within PROFILE» 
the names of libraries to search when locating a procedures and also 
the user names in whose catalogs those procedure tibraries reside. 
The general form of SEARCH jis : 


\ SEARCH search specs search specessecees 

where “search spec” is in the form 3: 
user name 
or 
(library names library _namecesees user name) 
The first form indicates that the library name contained in the 

predefined variabie SESLNAM is to be searched for in the catalog of 
the user specified by “user _name". The second form gives a tist of 


library names» with the last item in the tist being the user name in 
whose catalog those libraries may be found. 


Examples of SEARCH Directives: 


\ SEARCH USER» SSS» SES 


\ SEARCH (SESLNAMs CCG)» USER» SSS» SES 


The first example shows a simple SEARCH directive. The search 
order for procedures is firsts the currently togged in user's 
catalogs then the SSS catalogs then the SES catalog. The second 
example searches first in the library given by SESLNAM in the CCG 
catalogs then in the currentty logged in user*s catatogs then tn the 
SSS catalogs and finally in the SES catalog. 


Neate =: agnily one SEARCH directive is pracessed ger SES pracessor 
cali. Second and subsequent SEARCH directives are {gnored. 


Al~3 
CDC ~ SOFTWARE ENGINEERING SERVICES 
18 December 84 
SES User's Handbook ; REV: 4A 
A1l.O PROFILES 
Al.s1 LOCATING A PROCEDURE 


Re ERS AEN AD SND EE: NN Rt AEE ana ED END EO GAR AS AED ANN ME ANN AOD EN ED AY AE a ON SEN NS AE AG NS ER ED CD OND AD NED SD ED ND TD “AND A ND NS ENS a AE END NED ED OND le ENE ED ARS HN a 


Alel LOCATING A_ PROCEDURE 


The SES processor performs its search for a given procedure 
according to well defined and consistent rules. Basically SES has 
three methods of specifying how a procedure is to be tocated. The 
SES processor has an internal table which contains the following 
data 3: 


{ibrary_name i username 
library name user name 
etce 

etce 


etce. 


ae hh a ne Oh ee he wi 


a 
3 Fy 
a 2 
2 ! 
3 a 
FY r’ 
8 a 
a , 
a J 
a a 
E | 2 
a Py 
3 3 
3 2 
' 3 
a a 
a s 
a a 
I S 
4 rT 
+ + 


Given that the table may be set up by one of three different 
methods which are explained in more detail in the sections 
followings the procedure that SES follows to locate a procedure is : 


1. If there*s a tocal file of the "procedure_name™s whose first 
line is "procedure name", that file is used as the procedure. 


2e SES searches the catatog of the user whose user name appears 
as the first entry in the tables for a file of name 
"procedure _name™,s whose first fine Is "procedure _name"™,. If 
such a file is founds it ts used as the procedure. 


3. For each entry in the tables a search is nade for a library of 
name "library name" in the catalog of the corresponding 
“user name", and searches that tJibrary (which myst have a 
directory) for a TEXT record of name "procedure name". If 
such arecord is founds it is used as: the procedure. 


4. If the search is unsuccessful» an error message is issued 
-PROCEDURE procedure_name NOT FOUND- 
The next three sections provide amore detaited explanation of 
the methods by which the SES processor has its search table set up. 


The methods are basically the defaults the user name specified on 
the SES contro! statements and the SEARCH directive. 
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Alelel DEFAULT ORDER OF SEARCH 


When the SES processor is calleds it sets up the following data 
in its search tabte : 


G&SESLNAME |} user_unage 


a 
® 
2 
8 
3 
% 


oan 


; 
7 
+ &SESLNAME | ESESUNAME 
+ 


This table is the normal default for SES.’ "user name" is the 
user name of the current user. 


WSESLNAM™ jis a predefined variable which contains the name of the 
SES Library NAMe.e. "SESUNAM" is a predefined variable which contains 
the SES User NAMe. 


Alele2 SEARCH SPECIFIED ON CONTROL STATEMENT 


When the user types the SES control statenents he may specify via 
the UN or =U parameter of the SES prograns which userts catalog to 
fook in for the procedure specified by the call. For exampte 2? 


sessunzuser_nameeprocedure_name list of_parameters 


specifies that the procedure "procedure_nane”™ is to be searched (for 
only in the catalog of the user “"user_name”™ (if the procedure is not 
already tocal). In this case the SES processor modifies its search 
table to contain only the following data :° 


$ ween we $ nee = + 
+ &SESLNAM& } user name }$ 


where "SESULNAM" contains the SES Library NAMe as befores and 
‘user _name™ is the user name specified on the SES control statement. 
It is atso possibie to tel! the SES processors via the LIBPFN or 
LPFN parameter, the name of the tibrary to be searched for the 
procedure. For example 3 
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sesstipfnz=tib_name.procedure name list _of_parameters 


specifies that the procedure "procedure_nane”™ is to be searched for 
gniy in the tibrary *™libuname", In this case the SES processor 
modifies its search table to reflect the following data ;3 


+ Lib .name : user _nane | 


where “user _name™ is the user name of the current users and 
"lib name" is the tibrary name specified on the SES control 
statement. Of courses the UN and LIBPFN ovaramneters may be used 
together, 


Al.1.3 SEARCH ORDER SPECIFIED VIA SEARCH DIRECTIVES 


The third method of specifying the order’ tn which to fook for the 
procedure is via SEARCH directives in the user's PROFILE. For 
examples supposing that the users PROFILE cantains the Following 
SEARCH directive : 


\ SEARCH CHOLMLIBsJIMLIBsHG74)s AM74s° JFO3s (CANDYLIBSED73) 


in this case the SES processor would modify its search table to took 
like this : 


tonne $o---- -+ 
: HOLMLIB : HG74 : 
: JIMLIB i HG74 : 
; &SESLNAME AM74 
ESESLNAME JFO3 
ANDYLIB ED73 : 


Note : SEARCH directives are ignored if the UN) or LIBPFN 
parameters were specified on the SES control statenent. 
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B1.0 QPERATING MODES OF _THE SES PROCESSOR 


The SES processor processes procedures in one of four modes 3 


RUN This is the normal mode. The orocedure is processed, 
presumabiy generating control statements»: and then these 
contro! statements are executed, 


TEST In this mode the procedure is processed in the normal manner >» 
but the generated control statenents are not executed, 
instead they are placed on a designated file for possible 
inspection by the user. This node [fs neant as an aid in 
debugging new procedures. 


HELP This mode is similar to test mnodas however instead of 
generating control statementss a procedure set up for HELP 
mode produces some documentation on its purpose and usage. 


STATUS This mode is similar to test modas however instead of 
generating control statementss a orecedure set up for STATUS 
mode produces any change information avaitabte about the 
procedure. 


The modes are selectable by the user hy neans of parameters to 
the SES processor; and the procedure can determine in which of the 
modes it was called by means of predefined variables set up by the 
SES program. These variables are 3 


MODE This variable may be compared with the variables RUN» 
TESTs HELP or STATUS to determine which of the modes is in 
effect; for example : 


\ IF MODE = HELP THEN 
" code for HELP mode * 
\ ORIF MODE = STATUS THEN 
" code for STATUS mode * 
\ ORIF MODE = TEST THEN 
* code for TEST mode * 
\ ELSE 
" code for RUN mode * 
\ IFEND 


PRIMOUT This variabte contains the name of the PRIMary OUTput 
file. In RUN mode this is the new cortrol statement File; 
in TEST mode this is the file designated by the test mode 
parameter on the SES cali (default is SESTEST)$; and in 
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HELP or STATUS mode this is the file designated by the 
help or status mode parameter on the SES call (default is 
DUTPUT). PRIMOUT is particulartyvy useful in HELP mode for 
directing the descriptive infornation about the procedure 
to the file selected by the user’ on the SES call. This 
may be accomplished as follows ? 


\ IF MQDE = HELP THEN: 
Vv ROUT FA=PRIMOUT 
* descriptive information about: called procedure ™ 
: ROUTEND PRIMOUT 
\ STOP 
\ IFEND 
Note : in HELP or STATUS modes a PARMEND directive iis 


interpreted as a STOP directive, to prevent a procedure not set up 
for HELP or STATUS mode from doing strange or undesirable things. 


Ble1 SELECTING MODE _OF_ OPERATION 
As stated above,» the mode of operation for a procedure is 
selected by a parameter to the SES processor, 


TEST mode may be setected by one of the keywords + TEST» TMs or 
Te For examplfe 3: 


sesstest.procedure_name list lof parameters 


processes procedure "procedure_name”"™ in TEST modes and place the 
generated contro! statements on file SESTEST?: whereas 3; 


sesstzmy_file.procedure_name list iof_parameters 

processes procedure “procedure name" in TEST modes but places the 
generated control statements on File "my_file™. 

HELP mode may be selected by one of the keywords : HELP or He 
For example 3: 

sessheip.e-procedure_nane 

causes procedure “procedure_name™ to be processed in HELP modey = and 
any descriptive information available is otaced on file QUTPUT; 


whereas : 


sesshzmy_infoeprocedure_ name: 
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causes procedure “procedure name" to be processed in HELP modes but 
information available is placed on file "my_info"™. 
a list of 


any descriotive 
may 


Nete : that when calling a procedure in HELP modes 
parameters should not be given. HELP for a group of procedures 
be obtained by one call to SES» as follows 
sesshelp.eproclls; proc _23 


proc _3 


$ STATUS or 


may be selected by one of the keywords 


STATUS mode 
For example 3 
sesystatus.procedure_nane 


Ss 
STATUS modey 


2 
» 


in 


causes procedure "procedure name®™ to be processed 
and change information available is pliaced on file OUTPUTS whereas 


sesss=my_change.procedure_ name 
STATUS mode» 


in 


causes procedure "procedure_name™ to be procassead 
change information available is placed on File *my_change™. 
fist of 


but any 
Note : that when calling a procedure in STATUS modes a 
should not be givene STATUS for a group of procedures 
to SES» as follows 3 


parameters 
may be obtained by one cati 


sessstatuseproc_13 proc_2»s proc_3 
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C1.0 ERROR AND INFORMATIVE MESSAGES 


C1.0 ERROR_AND_ INFORMATIVE MESSAGES 


This appendix describes the messages produced by the SES 
processor when errors are detected. SES error nessages have been 
made as self-explanatory as possible. When an error is detected by 
SES» a message is printed In the form? 


** E CL 110013: EXPECTING "name found integer’ for’ parameter I" ON 
COMMAND STATEMENT 


The E—E at the beginning of the tine indicates this Is an error. 
message. 

The CL is an abbreviation for the Systen Comnand Language used by 
SES to do syntax processing. 

The number 11001 is an error code assigned to this error 
condition. 

The text which follows the error code describes the error in 
detail. Appended to the end of the text is: the !ine number of the 
line being processed by SES. In this First examples it is the 
command statement which is in error. 


After the error messages SES outputs the tine it' was oprocessing 
when the error was detected» followed by a tine containing an 
up_arrow at the point in the tine where the error was detected. 


SESeREWRITE [=123 O=ABC 


Usuatty the error actually occurred on the token just before the 
up_arroWe 


Here are two more typical examples of error nessages: 


** F CL 411007: REQUIRED PARAMETER ‘YISSING "I" ON COMMAND 
STATEMENT 
SES¢FORMAT 


** € CL 110112 UNKNOWN KEYWORD “"NVLS”" ON LINE # 7 OF PROC SEGMENT 
MYPROC 
PARM KEY = (C* group's "g") NVLS = 1 NAM 


Other abbreviations used in SES error’ nessages are SEs which 
means the error was detected in the processor itself,» and UT» which 
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means the error was detected by a utillty routine called by SES. 
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D1.-0 JSEMIMEQRMAL. SYNTAX _DESCRIPIION 


".eeWhat is the use of repeating all that 
stuff", the Mock Turttie tnterriuoteds "if you 
don*t explain it as you go on? It's by Far the 
most confusing thing I ever heard?" 

Lewis Carrot: 


This section gives a semi-formal description of the syntax used 
when writing procedures for and calling the SES.’ The description is 
not intended to be rigorous. First we introduce the "meta-ianguage" 
used to describe the syntax; second the char‘acter’ set used by SES is 
defined; and finally the syntax descriptior itself is given. 


Dl.1l THE META LANGUAGE 


This section describes the symbols used in the description of the 
SES syntax. 


aymbol Totereretation 
332 This symbol should be read as "ts defined to be*™, 


: This symbol! is used to indicate alternativess for 
example: A i! B means that either A or B is alitowed. 


<item> This group of symbots denotes that item is to be 
treated as a syntactic unit in relation to 
surrounding meta symbols. 


Citem] This group of symbols denotes that ttem is optional» 
ie@e zero or one occurences: of titen are allowed. 


{item} This group of symbots denotes that item may be used 
zero or more times. , 


Spaces are used in the syntax description to improve its 
readability» however they are not part of what's being defined 
unless otherwise noted, 
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There are a few instances where some of the meta symbots 
themselves are part of the syntax definitions and when this occurs 
the meta symbol is underlineds for example: i} means: the { character 
and not the meta symbol. When an _ appear’: alones it means itself, 


Di-3 
CDC - SOFTWARE ENGINEERING SERVICES 
| 18 December 84 
SES User's Handbook REV: 4A 
D120 SEMI~FORMAL SYNTAX DESCRIPTION 
D1le2 CHARACTER SET 


01.2 CHARACTER SET 


haracters used for NAMES 


o Zz B oe 2 asesesesese _ Letters 

« 9 eee sessesececencsesesens Decinal Nigits 
= ee eereneeseseseccsececesene Underline 

$ ceseeevesesncsesvasscseecens DOlliar Sigqn 

# aeveeeeensessesecssecese0ee« POUuNd 

a a eececeseveseneveseseseszcens Commercial At 


Characters used for INTEGER CONSTANTS 


0 ase J 00200002029 23239200992828 Decinal Digits: 

A oe F aee Ff eevee en02 8 Hexadecimal Digits 
{ eee esececsesecszesecseenz000e0s OQNeN Parenthesis 

) oceveesrsencesesesesseesecesece Close Parenthesis 


Characters used for OPERATORS 


eceseevessacccsecsecsezsesese Plus SIgGn 
ooeeaseer,ezsearsecrsessessesss Minus Sign: 
aeevescecceszeneesescseczeezsess Asterisk: 
sennecssecse2essesesececeses Stash (Siant) 
907992020222 08 2009098920808 888 Equal Sian 

a earsecsesesesececcocsessseseeee Greater Than Sign 
eorecevesesveseenesccesvece Less Than Sign. 


AVin~w eT 


Characters used for PUNCTUATION 


coevecsecsecssececseseeseese Blank (Space) 
eevee cesccsesescveseceseses COMMA 

eevee ersaesevessvecsesecess Open Parenthesis 
wpecesececeecsecsececsevesess Close Parenthesis 


aeseceseeesecsesssceccsezves Period 


os ww om 6 


Character used for STRING DELIMITER 


8 sav,evsesea seve esenensesenseaeee Apostrophe {Single Quote) 


Character used for COMMMENT DELIMITER 


big eeeeeeseesssesevsezsvsecsense (Double) Yuote 


D1-4 


COC —- SOFTWARE ENGINEERING SERVICES 


18 December 84 


SES User's Handbook REV: GA 


D1.e0 SEMI-FORMAL SYNTAX DESCRIPTION 
D1.2 CHARACTER SET 


{Defauit) Character used for SUBSTITUTIIN: DELIMITER 


& 


9000320008299 909806 000099999299 % Ampersand 


(Default) Character used for DIRECTIVE HEADER 


\ 


Note: 


aocrssesesecesevecseccesee Reverse Stash (Stant) 


Any ASCII character not listed it the above character set 
has no meaning to the SES processor. These characters may 
however be used in stringss comments», or as data 
characters. 
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D123 SYNTAX 


D1.3-1 BASIC DEFINITIONS 


<upper case letter> 3::2 Ai 86 {i CC i D0 Ef Fi G iH 
+ Fit dg t= KF Lt wens NO fe Pr 
+; O23 Rt SF Tiuivi? wi, 
: ¥ 3 2 

<tower case jletter> :3:= a3 bicidi et Ft aqith 
; § +t jg 3 kt tt at ntogp 
i qairis: titiueiv{t wis.x 
; ¥s 2 

<letter> t3:= <upper case letter> 

} <lower case ftetter>d 

<decimat digit> 2:3: 03313412: 3:43 «5 «6% «73 «8% 9 

<hexadecimal digit> ::= AtBicitiobieEtLrQr 
$5 as bi ec § dt ea ft F 


<digit> 32: decimai digit> 


z< 
! <hexadecimal digit> 


wo 
ou 
oO 
oe we 


D1.2362 TOKENS 


This section defines the building blocks of SES Syntax» 
colfectivety referred to as tokens. The internal token scanner of 
the SES processor is made available to the procedure writer by means 
of the built-in function TOKEN. 


<token> 323:= <name> { <number> ? <string> 
$ <detimiter> ! <operator> 
<name> %:32= <alphabetic char> {<atphabetic char> $ <decimal digit>} 
<alphabetic char> :32 <tletter> + . $$ 3 #4 4a 
<upper case name> 233 
<upper case fetter> {<upper case letter> } ¢€decimal digit>} 


All names are limited to thirty-one characters In lengths except 
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procedure names and procedure identifierss which are timited to ten 
characters. With the exception of <upper case nane>ss any name may 
be specified with either upper or tower case tatters» but before a 
name is used ait tetters in it are converted to upper case. For 
instance the names? ABCs abc» aBcs and so 39s are all equivalent. 
(This includes any of the "speciai™ namess such as DOs THENs WHEN» 
etc» In this descriptions howevers these ranes are always spelled 
out in upper case tetters.) 


<variable name> 2:32 <name> 
<function name> 22= <name>d 
<parameter name> 2%= <name> 
<directive name> 2:= <named 
<assignee> 22:= <parameter name> } <variabte nane>d 
<procedure named 23:= <name> 


<procedure identifier> 2:2 upper case Yame> 
<number> t:= <decimal digit> {<digit>} [E(<base>d)] 


<string character> 33s #? 
i <any ASCII character except > 


Cstring> 72:2 '{<string character>}! 


<constant> 332 <string> ! <number> ! Craned> 


<delimiter> 3: 


: € &£ ) = 5 0 & wells} 


B= » 
$ <end of tine> 


<operator> %*3= <graphic operator> i <mnemonic operator> 


‘ 


<graphic operator> 23: : /7 i eS = FFF 


f 
> 3: ' $= 7 2 4 2 


“t 
> 
= 
oO 


<mnemonic operator> 33 AR + XOR F NIV 
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01.323 USE OF SPACES 


Before discussing when and how spaces can be used we will first 
define the syntax of comments. 


<comment> s2= "{<any ASCII character excent %>}" 


In atmost ali cases a comment is treated identically to a singie 
blank characters and 2 or more contiguous: blank characters (or 
comments) are treated as a single blank character. Blank characters 
and comments treated in this manner are known aS so2aceSe 


Spaces may be used between tokens to imorove readability and in 
generat may be used to replace commas when used as arguments values 
or parameter separators. Spaces must be used to separate tokens 
when no <delimiter> or <graphic operator> can be used to separate 
them. For example the spaces between the tokens on the Following 
line must be present: 


V1 AND V2 
whereas the following two expressions are equivafient: 


Vi + V2 
V1+V2 


Furthers the following value fist contains 2 values: 
( X» -3 ) 
whereas the next contains only 1 vatue: 
( X +3 ) 
namely the value of the expression X=3. 


Spaces within character strings reoresent themselves, and 
comments may not be used in front of the \ which occurs at the 
beginning of directive tiness nor following the continuation signal 
at the end of directive or call linese Lines within procedures 
which are not directives or continuations of directives or lines 
which are read using the ACCEPT directives are treated as unquoted 
strings» and therefore spaces are significant in theme Whenever a 
fine is read by the SES processors trailing btank characters are 
deleted. Also» it is tegai to precede the \ of a directive line by 
one or more blank characters. 
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D1.304 EXPRESSIONS 
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<expr> 232 <iterm> {<or> <tterm>} 
€or> :3:= OR ¢ XOR 
<iterm> :3= <ifactor> {CAND <!factor>} 


<ifactor> : 


> = 
a= 


2 2 a 
soo 


<lorimary> 
<ret op> ? 
€sterm> 2323 ¢t 
<term> s3= (< 
<term op> 
<factor> 3:3 
<factor op 


oe 2 = 
asa 


<primar y> 


<operand> 3: 


oe Oe wee ae 


Cnull> 23: 
<variabie refe 


<function refe 


CNOT] <tprimary> 


€sterm> {<rel 
f= i ¢ 3 


erm> {++4 <term>} 


op> <5 
$2 3 


32 = § 


232 + $} 


> 332 # Gs 3 7d 


<operand> {** <operan 
C<variable reference> 

<function referenced 

( <expr>d ) 


<constant> 
<nullt> 


rence> 


rence> 


23 


tern>} 
23° 


term op>] <factor> {<tern 99> Cfactor>} 


% 


= <primary> {<factor op> <primary>} 


d>} 


333 <variable nama> 


s3= <function nane> Cargqurnents> 


<arguments> :3:= € [<arg> {2 <arg>}] ) 


€arg> 3:32: <¢nam 


<integer expr> 


€string expr>d 
<boolean expr> 


> <nudlo> 


e> } <expr> 


33= <expr>d must 
$32 <€expr> must 
33= <expr> must 

if 


if 


33333 23 3 


resolve to an integer 
resolve to a string 
resolve to an integer 
the value is zeros it 
is taken to be FALSE 
non=zeros itts taken 
to be TRIE 


3332323 35 2 83 
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D1.3-5 FOREIGN TEXT 


Foreign text is primarily used for parameter values which are to 
be in turn used as parameter fists (eege» to secondary procedures) 
or simply to prevent the SES processor from evaluating an 
expression. 


The scanning of foreign text is totally different from scanning 
*normal”™ text. The characteristics of this special scanning are 


- parentheses are "balanced" 

- singie and double quotes are "matched" 

- if not contained within parenthesess single quotes»s or 
double quotes, the tokens: commas periods, ellipsis 


(eefle})» and close parenthesis will terminate the scanning 
{and thus the foreign text value). In additions spaces 
which are used to separate namess numberss or strings from 
names numbers or strings will terminate scanning; as wit! 
an "unenclosed™ open parenthesis which foltows a string or 
number (Notes that an open parenthesis following a name 
does not terminate scanning - this ts hecause function 
references are allowed in for‘eian text but the foreign 
text scanner doesn't evaluate what ft scans» and thus does 
not know if the name is indeed the nane of a function). 


Foreign text may aiso be described as having the general format 
of an expressions but the expression is not evaluated when scanned 
as foreign text. During scanning comments and blanks not contained 
within singte quotes are “thrown away” and single blank characters 
are inserted between tokens which would otherwise not be separated. 


The following example illustrates some of the iditosyncracies of 
foreign texts 


\ vtist = *(a b c (d ed) 4p qt*ttr, st#* 123(8) (xsl y+3)) 2* 
\ count = VCNT (vtist) "2.0 
\ vatue = VALS (vilists 3) . 3" 
\ stist = GENLIST (vlists index) "4" 


The first line defines a value tist in the variable vtist. Line 
2 sets the variable count to the vatue 6. Line 3 sets the the 
variable value to the value: 
C(D €&) 
and tine 4 sets the variabie stist to the value: 


AsBsC{(D Eds *p qt?*ry 545123(8)5 (Xs f ¥43) ) 
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The next example illustrates how a paraneter ist may be passed 
as a foreign text parameters: 


\ plist = *( isinfile "columns" cols21..80 ozout }? 
\N count = VCNT (plist) 

\ low = VALS (plists 2» LOV) 

\ high = VALS (plists 2s HIV) 

\ stist = GENLIST (plists index) 


Count is set to 33 tow is set to: 
CoLs=1 
high is set to 803 and sttist is set to: 


T2INFILEsCOLS=1..80s020UT 


D111 
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D1.326 PARAMETER LISTS 


<parameter tist> ::= (€<parameter> {€51 <parameter >}] 
<parameter> i3= (<parameter name> [=]] <value tist> 
3} <parameter name> 
: <null> 


€value tist> %*2= <value>d 
+ { C<valued {€51] <valued}] ) 


<value> 33:2 <vatue sided [..f.} <value side>] 


<value side> i3= <expr> i <foreign text> 
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D1e3e7 SES PROCESSOR CALL 


<csep> 33:= [3] <end of tine>d 


3 2 
2 3 


<proc cail> 3:32 <procedure name> [5] <paraneter’ list> <csep> 
€control statement> i3:= <string> 


€control statements> %:= <control statenent> [<Ccesend] 
{{»] C<control stateneant>}? [<cesep>]} 


€call element> 3:23 <proc call> { <contro! statements> 


<SES call>d tis SES Cs <parameter fistd] . 
<call elementd {<calf alement>} 


Because of operating system restrictions» a <parameter list> 
following the SES (processor name) must have explicit punctuation. 
That is to says commas must be used to seoarate parameters (and 
values) and equal signs must be used to separate parameter names 
(keywords) from their value lists. 


Alsos the operating system is not well acquainted with tower case 
letters, so only upper case shoutd be used; howevers NAM/IAF (or 
TELEX) and the SES processor alleviate this orobien by converting 
lower case letters to upper case on command and continuation tines. 


When <contro! statements> are used in a SES call>s the SES 
processor insures that they are all “oronverty”™ terminateds ies» 
each <controt statement> string is scanned for a right parenthesis 
or period and if neither of these characters is founds a period wilt 
be appended at the end of the string; if howevers aeright 
parenthesis or period is founds the string wit! be fteft alone. NOTE 
that this is the only validity checking of the <controil statement>d 
done by the SES processor. 
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D1.3.8 SUBSTITUTION 


<substitute> 23= <parameter name> ! <vartable name> 
<default substitution character>d 3:2 & 


<ailternate substitution character> :;: 
PIMSRISE TLS Cay esaseder si 7s 
NS Ss rile li f£izdia 

€substitution char> 3:3 


<defauilt substitution character> 
; <alternate substitution character> 


z= 
ayt 38 68 2 8 08 
Oi esersass 2? 


<€substitution> s:s:= 
<substitution char> <substitute> <substitution char> 
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D1.329 PROCEDURES 


<procedure> ::= <procedure identifier> ({<procedure tine>d} 
<procedure line> s:= {<procedure tine eaiement>} 


€substitution> 


<procedure fine element>d t33= 
+ <any ASCIYL character> 


The process of substitution applied to a “orocedure fine> yieids 
an <object dined. 
<object line> :3:= <directive ftine> 
; <empty lined 
3 <data line> 


<default directive character> i3:= \ 


a 


<aiternate directive character> 
a 
4 aad 


PSMA SIAC esi tiet/ 


resi sez Li di Lids 


2 8 = 

oa 
wera snes 

ae 8 ay 


<directive header> i:= 
<default directive character> 
: <alternate substitution character> 
<directive lined 3:= <directive header> <directived 
<empty lined 33= 


<data line> s:= <any tine which is not "emoty"™ and does 
not begin with a directive header> 


Note: <empty line>s may contain connents enclosed in double 
quotese 
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D1i.3210 DIRECTIVES 


<directive> %3= <assignment> 
: <if while> <bootean exprd> CK<then dod}. 
1 <exit cycie> CWHEN <bootean expr>] 
; <directive name> <parameter list>. 


<assignment> ii <assignee> = Cexprd 
<if while> 3:32 IF $ QRIF $ WHILE 


<then do> 33 HEN 


= T 
: po 


€exit cycle> 2:2 EXIT ? CYCLE 
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D1e4 LINES. AND_THEIR CONTINUATION 


It is sometimes necessary to pass more par‘ameter’s to a procedure 
(or give more parameters to a directive) than will Fit on one line. 
To handle this problems SES processes continuation lines. 


The effective net resuit of using continuation tines is to 
construct an unbroken ftine of up to 2099 characters for calls to 
SES» or 256 characters for an SES directive.. 

Continuation may onty be used in conjunction with SES directives 
and when calling SES to process a owrocedure. Continuation is 
Signaliled on the tine which is to be continueds not the continuation 
line itself. Note that the <continuation signal> is not considered 


to be part of the tine. The mechanism for’ doing this is defined as 
Follows: 


{whole fline> 3:2 
<fine starter> <stuf 1> € <continuation signal>d 
€stuf 2> {€ <continuation signal>d 


stuf n>} j 


<continuation signal> ::= wef} 


Cline starter> %3= <directive header> <name> 
$ SES <parameter list» 


<stuf i> ::= <whatever belongs with the tine starter>d 
" 1¢2 i <2 n ® 
The effect of this is as If <whote Jline> had been specified as? 
<line starter> <stuf 1> {<stuf i>} 


Note: Syntactic units (tokens) may cross line boundaries. 
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E1-0 ACQUIRE UTILITY 


ACQUIRE is a program that enables easy retrieval Cacquisition) of 
permanent files. 


ACQUIRE combines the functions of the NIS "ATTACH™ and *"GET* 
contro! statements. For each file specified ACQUT2E determines if 
the file is already tocal to the job (untess: suporessed by the PO 
parameters see beltow)s if so it is rewound; if nots then for each 
one of a tist of user namess an ATTACH is attenpted (waitings if 
necessarys until the file is not busy)» and if that fails a GET is 
tried. If» after al! thiss the file is stilt! not ftocats an 
appropriate dayfile message is issued. 


Uniess the A (abort) parameter is specifieds ACQUIRE aborts only 
because of control statement format or argument errorss or because 
of a permanent file manager (PFM) detected error} and not because 
one (or more) of the specified files could not be Found. 


The control statement format for ACQUIRE is 3. 
ACQUIRE( 1 Fnl=zpfnlstifn2=epfn2secel001s0p2s e'e2) 
ifni is the (tocal) name of the file once it has been ACQUIREd 
{note that this is the name used in naking the "is the file 


already tocal?" test) 


pfni is the permanent file name for the file (tf zofni tis omitted, 
pfni is assumed to be the same as Ifni) 


opi specify options used for acquiring the File{s) 3 
A specifies that if a file Es not founds ACQUIRE 
should abort 
NA is the opposite of A (and is the default) 
PO specifies Permanent Oniys t.ee» that if a file fs 


already locals it is returned and then the ATTACH 
and GET are attempted 


UN=users specifies a tist of user names to be searched for 
each file (the user names are separated from each 
other by commas) 


M=mode specifies the access node desired for the file 
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(READ or R -= the defaults WRITE or Ws or EXECUTE 
or E). If the file is locals the mode wil! not be 
changed. To insure the node will be changeds the 
PO parameter should also he snecified. 
PWz=pw specifies the permanent Fillets: password 
PN=pn specifies the packname for’ the permanent file 
When ACQUIRE is attempting an ATTACH or GETs if the file is busy 
or if a permanent file utility is actives the following message is 
issued and the request is retried ; 
- WAITING FOR PFN=permanent file name JUNzuser name 


When ACQUIRE is attempting an ATTACH or GETs if an error is 
detected by PFM the following message is issued and ACQUIRE aborts 3; 


- ERROR WITH PFNzpermanent_file_nane UN=user name 


In both of the above casess, the designated nessage is preceded by 
a more specific message generated by PFM. 
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F120 EDT - ENHANCED VERSION OF NOS TEXT ENTTOR 


F1l.0 EDT. -_ ENHANCED VERSION OF _NOS_TEXT_ EDITOR 


EDT is an enhanced version of the standard NOS text editor 
{EDIT). EDT incorporates column searchess modified FIND and FINDS 
commandss Input and Output file and TAB specification on the EDT 
call» control over terminal interrupts,» INPJT MODE optionss multiple 
entries on command liness command buffers» oermanent file functions» 
and miscellaneous other additions. 


User documentation can be found on TQOLDGS (SESD009). 


Flel EDT_CONTROL STATEMENT FORMAT 


EDTsTifnilsCtfn2)],Cifn3}sCtabj]~{Cemdstr] 


ifni - name of the file to be edited 


tfn2 name of the file containing the editor commands 

(default = INPUT) 

- if QO» an END command is executed after processing the 
commands in cmdstr 

- if ly» commands are read fron File INPUT after 


processing the commands in cadstr> 
ifn3 - name of the output flie (defaudt = OITPUT) 
tab - tabset to be used by EDT 


emdstr - editor Command String to be executed if ifn2 = 0 or 1 
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G1.0 EXTRACT UTILITY 


EXTRACT fis a program that enables easy retrieval of records from 
permanent file (or ftocail) iibraries. 


EXTRACT is similar in function to the NOS "GTR™ statement. It 
differs from "GTR™ in the following ways: 


o EXTRACT insists that the tlibrary to be searched has a 
directory (a directory can be built using the NOS utility 
MLIBEDIT™). 


o The record type parameter for EXTRACT>» if givens applies to 
all records to be extracteds and if rot givens oniy the names 
of the records are used when searching the library. 


o Each extracted record is copied to its awn tocal file by 
EXTRACT, rather than all to the same Files. 


o EXTRACT does not insist that the library to be searched be 


focal to the job when it's calleds but ACOUTRE*s the library 
from a permanent file catalog. 


The control statement format is? 


EXTRACT( 1 Fnlernlsifn2=rn2s .e2e73D19 900279 che} 


ifni Is the tocail file name given to the record once it's 
extracted (!fni is REWQUND before and after the extraction 
takes place). 


rni Is the name of the record to be extracted (if omitteds it is 
assumed to be the same as Iifni). 


opi These parameters specify options that control the extraction 
process 


A Specifies that if a record is not founds EXTRACT 
should abort. 

NA Is the opposite of A land is the default). 

T=rt Specifies the record tyne Cif givens it applies 


to all records being extracted; if omitteds only 
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the record names are used when searching the 


Jibrary). 

L=libname Specifies the name of the library to be searched 
for the records (if omitteds "PROCLIB" is 
assumed). . 


LFN=tlibifna Specifies the tocat file nane for the Iibrary 
{if omitteds the "libnane™ Fron the Ll paraeter 
is used). Note that this fs the name used to 
make the “is file tocal?" test when <ACQUIRing 
the library. 


UN=un Specifies the user name of the permanent file 
catalog to be searched for "“"tibname”™ if it*s not 
already local (if onitteds the current user is 
assumed). 


PW=pw Specifies the library's pernanent file password. 


PN=pn Specifies the library's permanent file packname. 


Valid record type designators are documented under the 
description of the "CATALOG" control statenent in the NGS Reference 
Manual. 


In addition to these standard typess there's one more "type" 
processed by EXTRACTs which is designated by "TXT". This "type" is 
used to denote "TEXT" records thats» when extracteds are to have 
their first tine (which contains the record’s name) “stripped off". 
This is useful ifs for examples one has records containing 
directives for a NOS utility» in whith case the name of such a 
record is in alll likelihood an ttitlegal directive to the utility 
programe 


EXTRACT aborts under any of the folfowing conditions: 
+) format or argument error(s) on the control statement 


o the specified tibrary could not be AQJTREd 


0 the tibrary file does not have a directory as the tast record 
before end-of-infor mation 


Notes howevers that EXTRACT doesn't abort if it does not find any 
of the requested records ({onty an infornative dayfile message is 
issued)», unless the Abort parameter is coded on the call. 


Gi=3 
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If the tibrary file is not local to the job when EXTRACT is 
calieds it is RETURNed when EXTRACT terminates nornalty; but» if the 
library File is tocal, EXTRACT REWIND's it oritor to normal 
terminatione 
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H1.0 SESMSG UTILITY 


H1e0 SESMSG_ UTILITY 


SESMSG is a program which copies the connent field of its cail 
fine to a file. The control statement format ts. 


SESMSGsfile.message 


file is the name of the file to raceive the message (if 
omitteds OUTPUT is assumed) 


message is the message to be written to the file 


The message is written to the file only If the File is a terminal 
file, or if "file" is explicitiy quoted on the call line. 


SESMSG is used in procedure files to Infora the user about what 
the procedure is currentty doing. It is atso used for creating 
files of input directives to utility programs when such directives 
are dependent on execution time considerations. 


Il-1. 
CDC — SGFTWARE ENGINEERING SERVICES 
18 December 84 
SES Userts Handbook REV: 4A 


OOO aha AE Ty TOD HATRED ANS EEA AAO ANOS AOD AED TS SND ANS ENED AG SN A Gy I-A EDEN EN A-SI SND CPD AEDES SEND ND “AOD GOURD ARAN ONDA EN «YE <A - -D -D - S  - 


11.0 JOBID - PRODUCE LARGE PRINT BANNER 


T1.0 JOBID_ -_ PRODUCE LARGE PRINT. BANNER 


JOBIB is the program used by the SES PRINTID procedure to produce 
"large print” banner pages. 


The output oroduced is one or more sages of 5 Lines of block 
characters at 10 characters per line. AY! envoty character positions 
and tines are blank filled. Additional pages of block lettering is 
produced if any information is specified following a fifth delimiter. 
characters and so one 


The input to J0OB8ID is a string of characters tin the following 
form 3 


linel/line2/line3/tine4/lined 
or 
ffi telinelt+tline2+tine3s+linestiinesd 


In the first form the slant (/) character’ is taken to be the 
delimiter between tines (ieees it is the default delimiter). The 
second form must be used when you want one or’ more of the tines to 
contain the stant character. In the exannole aboves the delimiter 
has been changed to a ptus (+) character. 


Note : that only characters with 4 HK-bit display code 
representation can be given to JOBID. To oroduce a coton (2) on 
output you should use a percent sign (%) on input. Unnecessary 
delimiters after the message data should be omitteds otherwise a 
trailing delimiter may be printed. 


Automatic Date and Time Substitution 


Once JOBID has broken the message fieid tnto message tines based 
on the delimiter characters the front of each field is examined for 
the following sequences of characters 3: 


YDATE 
YTIME 
YETAD 
)AMPM 


Whenever these character sequences are founds the message line on 
which they occur is replaced with the curreit value of the indicated 
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parameter. {NOTE that the right parenthesis must be the First 
character of the message tine on which it occurs). 


The above "commands®™ produce the following types of resuits 3 


YDATE 17 SEPT 74 
YTIME 14218221 
YETAD 74/09/17 (date reversed) 
YAMPM 32:05 PM 
AOBID_ Examples 


GRAPL/SOLDOPL/TAPE =/ 7777 

TEXTJAB/COMPILE/ OF/IDATE/) TIME 
7/774+CREATED ONt 17/097 7444LATEST RINFt) DATE 
SEND TO/MEADOWVALE/RGOM 888 
JDAYFILE/DUMP/)ETAD 


The above calis produce the results shown below 3° 


GRAPL TEXTJAB CREATED ON SEND TO | 
OLOPL COMPILE 17/09/74 MEADOWVALE DAYFILE 
TAPE = OF - RJM 838 DUMP 

7777 17 SEPT 74 LATEST RUN 74/09/17 


13335226 18 SEPT 74 
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J1-0 IXTHEAD DOCUMENT. (HEADINGS) POST=PROCESIOR 


Sometimes the header material generated by TXTFORM is not desired 
or TXTFORM is unable to produce a needed header format. The TXTHEAD 
utility processes a TXTFORM output files which contains speacia! 
TXTHEAD instruction pages» and removes the ofd header material 
and/or inserts the new heading material. Additionally» an 
incrementing page number can be produced at any position within the 
header texts or the TXTFORM page number may be passed to TXTHEAD for 
placement into the header region. 


COMMANDS ACTION 

J/7HEAD New heading material follows until another /// is 
encountered in columns 29354. 

7//END Usually marks end of special heading material. 

77/7 PAGEL-Inn Set page number for next sage to 1n. If negatives 
the page number is not printed until it increments 
to l. 

//77/LINENNA Line nn of header on which to put a page number. 

J/7COLUMNAN Column position for units digit of page number is 


nns for TXTHEAD generated page noses and =“*for 
TXTFORM generated page nunbers the column” position 
specifies the location of the left hand side of the 


page number. (Count inctudes carriage control 
column). 

J// ADDNODnnv Number of header tines ts be added is nne Default 
is add all tines given. 

///DELETEnn Number of tines to be deleted Fron top of each page 
is nne 

///7OBLDNO Use the TXTFORM generated oagfe nose 

///NEWNG Use the sequentially generated TXTHEAD page nos. 


This is the default condition... 
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To give these commands to TXTHEADs the following type of format 
should be used in a TXTCODE document at the pniliace where the change 
is to occur. 


\asis 

\marginl 

Viength80 

\page 

/iihead 

1 KE KEKE KE KKH KE RH 
* * 
* HEADER TEXT * 
* * Page 
ae oe oe ee Ke HK HK KH KK & 

fftend 

/ilpagel 

4Jitine3 


/7fcotumn65 
//idelete3 
\m ar gintd. 
\length6é2 
\block 
\page 


Notes : 


Header information as well as any speciflabte information may be 
defined or redefined anywhere. O'd watues remain set until 
replaced. The page number may be etiminated hy soecifying //#lined 
or any out of range vaiue. 


Any size header Is permissible. It Is also possible to supply 
folio information for pages by putting the nage eject at some point 
after the first tine of header material. Cotumn one of the header 
information is assumed to contain printer control characters such as 
*hlank™»s +2 -» O» etce 


A great deal of flexibility is avaifable for special page 
formats. 
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K1.0 JABFORM CONVERSZTONS 


The following is a table of conversion oerformed by JABFORM 3; 
TEXTJAB IXTEQRM 
-A- \A 


~BKX=se009ZZ2™ 


~BBXXsee20ex 22> 


\BxxX2eeces 72 
\BBxxe cess 22 


-E- \E 
-F- \F 


~GxXXs 00 09 Z2- 
“HN~“Y.2YC oe 2S 


\SX Xe s0esZ2 
\HN 


S . * ” C 
~IN- ATTN 
~JN-=- AJN 
-KN- VEN 
-L~ AL 
-- ‘Sy 
-Nx=- \Nx 
-O- VD 
=—p= \o. 
=-Q- \9 
=-R=- \R 
~SN=- VSN 
-T- \T 
~.2TN- \.TN 
aaj \J 


~VXX»9 eeexZZ—= 


—~VVKXXeae0e0x22- 


\Vxx9 0 sies 22 
AVX Xa eces 27 


-XN= VXN- 
-J= \Z 
—~- (MINUS MINUS) \ 


~ANY COMBINATIONS OF EDIT CODES- 


VO OMBINATION OF CODES 
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TEXTIAB 


*ARABIC+ 
+AUTO* 
+CARDLNXX+ 
+CHANGEsC+ 
+DATEXXXXXX 


#DEP THX X+ 
+DQUBLE+ 
+EIGHT+ 
+ENDT + 
+FOLIO+XXXXXX 


+HEADA+ 
+HEADA=XX+ 
+HEADB+ 
*#HEADB=XX+ 
+HEADC+ 
+HEADC=XX+ 
+JUST+ 
+LENGTHNN+ 


tLIST (Xs eee sXJtTITLE 


+MARGINXX+ 
+NOAUTO+ 
+NOJUST+ 
+NOPTAB+ 
#NOSEQ+ 
+NOSOURCE+ 
+PTABt 
+RECORDXXs YVY+ 


+ROMAN+ 
+SEQ+t 


IXTEQRM 


discarded 

discarded 

VRECORD15<X 

\CHANGEsC 

ADATE 

KXXXXX 

VFORMAT » 9XX 

\SPACE2 

discarded 

\ (See +TaAsle+) 

\FOLIO 

XXX XXX 

\VHE ADA 

NHEADA (2X%X discarded) 
\VHE ADB 

NHEADB (=X%X%' discarded) 
\VHE ADC 

VHEADC (2XX° discarded) 
\just 

\VULCENGTHNN 

(After this» JABFORM only processes 


column 1 thru NN3 WN4#L to EQL is passed 
thrue) 


ALISTX» wo00X 

TITLE 

(discards °= and =) 
\MARGINXX 

discarded 

ANOJUST 

discarded 

\NOSEQ 

discarded 

discarded 
VRECORDXXsYY 

(After thiss JA3FORM onty processes 


columns XX thru YY; colflumn 1 thru XX-1 
and YY+l to EVL wil’ be passed thru.) 


discarded 


\SEQ 
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TEXTIA8 
+SETA+C 


+#SETC+C 
+SETE+C 


#SETQ4C 
+SETS+C 
#SETUCC 


+SETTABI=XX 90009152774 
+S INGLE+ 

+S IX+ 

+SQURCEF 

+SUBTITLE+X XXXXX 


+TABLE+ 


+TITLE+XXXKX XX 
+TODAY+ 
*C 


Coe el! {apostrophies) 
$C ee CH 


IXTEQRS 


discarded 


(JABFORM recognizes 


the C as 


alter code fron now ons) 


discarded 

discarded 

(JABFORM recognizes 
code from now 9n.) 

discarded 


(JABFORM recognizes: 


capitalize string code 
discarded 
{JABFORM recognizes 
special character code 
discarded 


({JABFORM recognizes 


the C as 
the C as 
from now 


the C as 
from now 


the C as 


an 


an edit 


ones) 


the 
on.) 


the 


underline string code from now one) 


\SETTABIXX» 00521527 
\SPACE1 

discarded 

discarded 

ATITLE2 

XXX XXX 

\COMMENT 


+TABLE+ (Inout thru next endt is not 
processed»s but passed to TXTFGRM as a 


comment shifted to the right one 


spacee) 
+ENDT+ 
\ 
\TITLE1 
XXX XXX 
\TODAY 


*C (CC is not capitalized - ASCII 
6/12 TEXTJAB inout does not use this 


feature.) 
CoeeC (capitalized) 
\UNDER 
Cee el 
\VUOFF 
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K1.0 JABFORM CONVERSTONS 


LEXTJAB IXTEQRM 

7A + {(pfus) 

7B 1] iclosing bracket) 
7C % (single quotes grave accents or closing quote) 
70 # (dollar sign) 

VE 3; (semicolon) 

/F > (greater than) 

/G < (less than) 

7H + (pitus) 

7T \BLANK1 

/3 ~ (underline) 

1K % (percent) 

7L {unknown —- blank) 
7M & (Campersand) 

iN t{exctamation) 

70 = {equai) 

/P * (asterisk) 

/Q {commercial at) 

7R * (apostrophe or opening quote) 
13S - (minus) 

sT 2 (colon) 

4U # (pound) 

Al {C (opening bracket) 
‘Wi ? (question) 

*#X * (asterisk) 

1Y " {quotation marks) 
12 4 (stant) 

70 0 

41 1 

42 2 

13 3 

14% & 

45 5 

16 6 

17 7 

/8 8 

49 9 
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TEXTIJAB IXIEQRM 
7{(spacedleS \COMMENT 

CoC 
1* * (asterisk) 
/t ' (singte quotes grave accents or closing quote) 
I~ - (minus) 
/+ + (plus) 
7% % (dolfar sign) 
7¢ {C (opening bracket) 
| ] (closing bracket) 
7* " (quotation marks) 
VIA + (plus) 
478 + (closing brace) 
ric * (circumflex) 
770 * (single quotes grave accents or closing quote) 
FFE ' (apostrophe or opening quote) 
“7/F \dreverse stant) 
4716 {commercial at) 
7d + (pius) 
aR’ (space) 
443 + (plus) 
441K : (vertical tine) 
Fst - (minus) 
77M ; (vertical line) 
ZN ~*~ (tilde) 
4770 " (quotation marks) 
77P (space) 
aA) {space} 
7IR (space) 
“1s {space} 
“iT (space) 
440 + (pius) 
wIN { (opening brace) 
iw * (asterisk) 
71K * (asterisk) 
7X + (ptus). 
17 \(reverse stant) 
4éf f/ (stant) 
776 & Campersand) 
NOTES 3 


1) j$<If JABFORM is passing columnss unprocessed data in the passed 
columns on input is. in the same cotfumns on output. Blank 
paddings when requireds is done to acconotish this. 

2) Alt’ TXTFORM codes are put on a tine by themselves. 


3) Al} TJEXTJAB codes {except +TABLE+) that have no TXTFORM 
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conversion is converted to EDL and a nessage sent to ERRFILE. 


CAUTION 3 


1) 


2) 


3) 


The TEXTJAB source XXX *yYY!* converts to ? 

XXX 

\UNDER 

YYY 

\UOFF 

Which lists as XXXYYY. To get a space before the first Ys the 
TXTFORM source must be changed to have a soace before the Y. 


TXTFORM can only handie tine tength uo thru 100 characters on 
output and TEXTJAB ailows 120. This neans the +#LENGTH+ code 
will convert OKs but TXTFORM will not process correctiy. 


TXTFORM can onty handie tab settings up thru 99 and TEXTJAB will 
handie 119. This means a TEXTJAB SETTAB alter code wil! convert 
OKs but TXTFORM will not be able to handle it correctly. 


Example : 


+SETTAB7=103»5 8=113+ 

This will convert to : 

\VSETTAB 710328113 - with tab number 71 and 81 with columns of 3 
and 13. 
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L1.0 CHARACTER _SET_TABLE_ (USED BY CONV) 


The following tabie shows the ASCII char‘actars and the internal 
octal codes that represent them within the various character sets 
that are processed by the CONV utility. 
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L1e0 CHARACTER SET TABLE (USED BY CONV) 


ASCII N63 N64 ASCIT4 

GRAPHIC NBE63 NBE64 N612 NBE63A NBES4A ASCII N612U N612L 
> (COLON) 63 00 7404 O72 972 072 7404 7404 
A 01 01 ol 101 LOL 191 01 = 
B 02 02 02 102 192. 102 02 = 
Cc 03 03 03 103 1933 193 03 = 
D 04 04 04 104 134 104 04 - 
E 05 05 05 105 195 1095 05 = 
e 06 06 06 106 196 196 06 = 
6 O7 07 07 107 197. 197 07 = 
H 10 10 10 110 119 110 10 - 
I 11 1i 11 111 11. 111 11 = 
J 12 12 12 112 E12 112 12 cs 
K 13 13 13 113 113 113 13 = 
L 14 14 14 114 114 114 14 ~ 
M i5 15 15 115 115 115, 15 = 
N 16 16 16 116 115 116 16 = 
0 17 17 i7 117 117 117 17 = 
P 20 20 20 120 129 120 20 = 
Q 21 21 21 121 121° 12 21 = 
R 22 22 22 122 122 122 22 “ 
S 23 23 23 123 123 123 23 “= 
T 24 24 24 124 124 124 24 = 
U 25 25 25 125 125 125 25 = 
V 26 26 26 126 125 125 26 - 
W 27 27 27 127 127 127 27 - 
X 30 30 30 130 139 130 30 = 
Y 31 31 31 131 131° 131 31 = 
Z 32 32 32 132 132 132 32 = 
0 33 33 33 060 9590 059 33 33 
1 34 34 34 061 951 051 34 34 
2 35 35 35 062 052 062 35 35 
3 36 36 36 063 943 953 36 36 
4 37 37 37 064 95% 054% 37 37 
5 40 40 40 065 965 055 40 40 
6 41 41 41 066 055 956 41 41 
7 42 42 42 067 047 057 42 42 
8 43 43 43 070 079 070 43 43 
9 44 44 44 O71 O71 O71 44 44 
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L1.0 CHARACTER SET TABLE (USED BY CONV) 


ASCII N63 N64 ASCIT4 
GRAPHIC NBE63 NBE64 N612 NBE6G3A NBES4A ASCITS N612U N612L 
+ (PLUS) 45 45 45 053 953 053. 45 45 
- (MINUS) 46 46 46 055 055 055 46 46 
* (ASTERISK 47 47 47 052 052 052 47 47 
/ (SLASH) 50 50 50 057 O57 057 50 50 
( (LEFT PAREN) 51 51 51 050 059 950 51 51 
) (RIGHT PAREN) a 52 52 051 9510 051 52 52 
$ (DOLLAR SIGN) 53 53 53 044 044 044% 53 53 
= (EQUAL) 54 54 54 075 975 075 54 54 
(SPACE) 35 55 55 040 04). 040 55 55 
9 (COMMA) 56 56 56 054 954 054 56 36 
e (PERTOD) 57 57 57 056 956 954 57 57 
# (POUND) 60 60 60 043 043 043 60 60 
C (LEFT BRACKET) 61 61 61 133 133 133 61 61 
J] (RIGHT BRACKET) 62 62 62 135 135 135 62 62 
% (PERCENT) * 63 63 = 045 945 63 63 
" (DOUBLE QUOTE) 64 64 64 042 042. 042 64 64 
~ S‘UNDERLINE) 65 65 65 137 137 137 65 65 
$ (EXCLAMATION) 66 66 66 041 041° 041 66 66 
& CAMPERSAND) 67 67 67 046 045 946 67 67 
* CAPOSTROPHE) 70 70 70 047 947 047 70 70 
? CQUESTION) 71 71 71 077 OTT 077 71 11 
<€ (LESS THAN) 72 72 72 074 O74 074° 72 72 
> (GREATER THAN) 73 73 73 076 076 076 73 73 
@ (COMMERCIAL AT) 74 74 7401 100 199 100 7401 7401 
\ (REV. SLASH) 75 75 75 134 134% 134 | 75 75 
“ (CIRCUMFLEX) 76 76 7402 136 135 136 7402 7402 


(SEMICOLON) 77 17 77 073 073 073 77 77 


we 
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ASCII N63 N64 ASCII4 
GRAPHIC NBE63 NBE64 N612 NBE63A NBESSA ASCIIS N612U N612L 
7601 141 ad 7601 
7602 142 = 7602 
7603 143 = 7603 
7604 144 - 7604 
7605 145 - 7605 
7606 146 < 7606 
7607 147 - 7607 
7610 150 ae 7610 
7611 151 = 7611 
76le2 152 = 7612 
7613 153 = 7613 
7614 154 = 7614 
7615 155 = 7615 
7616 156 a 7616 
7617 157 = 7617 
7620 160 = 7620 
7621 15L ~ 7621 
7622 162 = 7622 
7623 153 = 7623 
7624 154% ad 7624 
7625 155 = 7625 
7626 156 = 7626 
7627 1457 = T7627 
7630 170 = 7630 
7631 171 = 7631 
7632 172 = 7632 


Ne X Ee cerunnwr DnvVeODTD Sa Fue rono ao ces 
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L1.0 CHARACTER SET TABLE (USED BY CONV) 


ASCII N63 N64 ASCII4 

GRAPHIC NBE63 NBE64 N612 NBES&3A NBESSA ASCITS N612U N612L 
{ (LEFT BRACE) 7633 173 7633 7633 
$ (VERTICAL BAR) 7634 174 7634 7634 
} (RIGHT BRACE) 7635 175 7635 7635 
" (TILDE) 7636 176 7636 7636 
DEL 7637 177: 7637 7637 
NUL 76490 090 7640 7640 
SOH 7641 N91 7641 7641 
STX 7642 092 7642 7642 
ETX 7643 093 7643 7643 
EQT 7644 094 7644 7644 
ENQ 7645 995 7645 7645 
ACK 7646 096 7646 7646 
BELL 7647. 097 7647 7647 
BS 7650 010 7650 7650 
HT 7651 O11 7651 7651 
Le: 7652 012 7652 7652 
VT 7653 013 7653 7653 
FF 765% O14 7654 7654 
CR 7655 015 7655 7655 
$9 7656 016 7656 7656 
SI 7657 917 7657 7657 
DLE 7660 029 7660 7660 
DC1 7661 021 7661 7661 
0C2 7662 022 7662 7662 
DC3 7663 023 7663 7663 
DC4 7664 024 7664 766% 
NAK 7665 025 7665 7665 
SYN 7666 026 7666 7666 
ETS 7667 027 7667 7667 
CAN 7670 030 7670 7670 
EM 7671 931 7671 7671 
SUB 7672 032 7672 7672 
ESC 7673 033 7673 7673 
FS 7674 934% 71674 7674 
6S 7675 935 7675 7675 
RS 7676 | 036 7676 7676 
US 7677 037 7677 7677 


* (GRAVE ACCENT) 7407 140 7407 7407 
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M1.0 DIFFERENCES BETWEEN MODIFY AND MADIFY 


A AG AN EER SEED AE EE NE NE AE A A A ED ED GUNN GEE SEED A GONG TD AED ND AED A NE AE EN ND EP ED RON ND AN ES SE ND ND ED AE AN ED (ED AD ED EDD ED AE AED A ND ED AED OE ED ED ED OS ee 


M1.0 QTEFERENCES. BETWEEN MODIFY AND MADIEY 


Gener al MODIFY: MADIFY 
6/12 character set support no yes 
Field Length management yes no 
Nested CALLs no yes 
Default line tength 72 110 
Maximum fine width 109° 120 
Compile File sequenced by default yes no 
SEQ directive allowed in 

input stream no yes 
Value can be specified with 
DEFINE directive yes” no 

Control Statement 
Product Set Format yes no (/required) 
CV option yes no 
$l through S5 options no yes 
NN option (no-nesting of CALLS) no (default) yes 

Compile file 
IF/ELSEZENDIF directives yes no 
IGNORE directive yes no 
CALLC option (conditional CALL) no yes 


Other Differences 


1. MADIFY inctudes the following additional ootions = 

$1 - Do not write the “deckname"™ or "SOMMON® on the SOURCE 
file, 

$2 - Do not expand CALL directives on the COMPILE files 
uniess EDIT is specified. 

$3 - Allow empty INPUT and OPLFILE directive files. 

S4 - (Specified as DEzname)e. Write only the deck specified 
by “name”™ and alti COMMON decks onto the new program 
library. 

$5 - Allow *CREATE directive without the first image of the 
CREATE file being a deck name. Deck rame defaults to 
*SESOPT™. 

NN ~- Do not process nested CALLs.’ That is» if a directive 
which would ordinarily require expansion of a COMMON 
deck appears in a COMMON decks do not perform the 
expansion. 


2e The compile file directives CALLC, Inhibits the expansion of 
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M1.0 DIFFERENCES BETWEEN MODIFY AND MADIFY 


3 


4. 


the specified deck if the deck specified has already been 
expanded within the outermost deck of the CALL nest. 


MADIFYs although processing 6/12 characters» is based upon a 
63<—character set MODIFY and therefore does not handie display- 
code colons property. 


MODIFY and MADIFY new program jiibrarities can be processed only 
by the program which generated them. 
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N1.0 MECHANISM FOR COLLECTING USER SUPPLIED SOFTWARE 


This mechanism defines when and how SES makes user developed 
software tools available to the entire SES user community. The 
mechanism is based on the assumption that it Is beneficial to gather 
tools developed by people outside the SES organization Into a 
commons Known location. 


Niel QBTAINING USER SOFTWARE 


The user supptied software which is assenbled and made availabie 
by SES falis into the area generally considered as “"tools"®. It is 
sufficiently general purpose so it is useful to oeopte other than 
the originator. It is comprised of SES oroceduress programs or 
modules. 

Software supplied by a user is totally transferable to another 
catalog. It is not dependent on any develooer'’s catalogs or any 
catalog other than the one the toot itself resides in. If the 
software being supptied is a program or nodules the source code is 
supplieds along with a build procedure that Is atso totaily 
transferable to another catatog. The author can request the source 
remain unaccessible to other users. 

In addition to the actual softwares, the uwser submits the 
following documentation: 

A) <A short description of the tools which is kept in an online 
directory of user supplied toots along with the supplier's 
names location and extension. 

B) Documentation on how to use the software, The more 
complete it iss the fewer phone calls the supplier 
receives. 

C) SES procedures contain HELP documentation that assist 
someone in using the procedure, 


N12 MAKING USER. SOFTWARE AVAILABLE THROUGH SEX 


When SES obtains user devetoped softwares it is handied in a way 
simitar to SES developed software. Procedures are coftected on a 
procedure tibrary calted USRPLIB in the SES catalog. Binary files 
are assigned USS numbered filess and are kent in the SES catalog. 
The source for user supplied software is collected onto a 
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semi-private SCU PL called USSPL and kept in the SES catalog. If 
the author requests that it not be accessib!es the source is kept in 
a private SES file. 

The major advantage of maintaining user sunolied software is the 
SES catalog is than any changes or new software are automatically 
sent to the sites receiving the regular SES updates.’ 


N1.3 COMMUNICATING AVAILABILITY OF _USER_SJOOL TED _SQETWARE 


An online directory (USSINFO): of user’ supolied tools. is 
maintained on the SES catalog. This file contains a short 
description of the tool provided by the developer’. This description 
is also circulated via the Advanced Systens: Develoonent Productivity 
Circle and/or the SES Toots Bulletin. 

Hard copy documentation supplied by the user ts availiable from 
SES on request or ontine via TOOLDOC. 


N14 SUPPORT OF _USER SUPPLIED SOFTWARE 


All correctionss improvements or other nodification to user 
supplied software are the responsibility of the person supptying the 
software. SES does not support any user ssoplied software. 

If software supplied by a user is standardized {it becomes a SES 
supported product) it is removed from the user suoplied category. 
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